discourse/docs/ADMIN-QUICK-START-GUIDE.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

147 lines
11 KiB
Markdown
Raw Normal View History

:hatching_chick: Congratulations, you are now the proud owner of your very own [Civilized Discourse Construction Kit](https://www.discourse.org)!
2013-12-16 09:46:46 +08:00
## :sun_behind_small_cloud: Overview
2013-12-16 09:46:46 +08:00
Discourse is a powerful and flexible platform with many options for customization that you'll want to explore over time.
To get started, we recommend you follow the sections below for each of the following:
2013-12-16 09:46:46 +08:00
- [ ] [Test your email configuration](#email-test-your-email-configuration-2)
- [ ] [Complete the setup wizard](#magic_wand-complete-the-setup-wizard-3)
- [ ] [Invite a few people to join you](#handshake-invite-a-few-people-to-join-you-4)
- [ ] [Discuss ideas with your community](#thought_balloon-discuss-ideas-with-your-community-5)
- [ ] [Update your welcome topic and guidelines](#wave-update-your-welcome-topic-and-guidelines-6)
- [ ] [Adjust other customizations](#art-adjust-other-customizations-7)
- [ ] [Repeat!](#arrows_clockwise-repeat-8)
- [ ] [Launch your community](#rocket-launch-your-community-9)
2013-12-16 09:46:46 +08:00
> :bulb: If you need to get back here later, scroll to the top of any page and click the <kbd>Getting started</kbd> button.
2013-12-16 09:46:46 +08:00
## :email: Test your email configuration
2014-02-13 03:50:01 +08:00
Email is required for new account signups and notifications. **Test your email to make sure it is configured correctly!** Visit [the admin email settings](%{base_url}/admin/email), then enter an email address in the "email address to test" field and click <kbd>send test email</kbd>.
2014-02-13 03:50:01 +08:00
- You got the test email?
Great! **Read that email closely**, it has important email deliverability tips.
- You didn't get the test email?
Email deliverability is important to ensure users get signup emails and other notifications. Please see [Recommended Email Providers for Discourse](https://github.com/discourse/discourse/blob/main/docs/INSTALL-email.md) for template configurations for different providers.
> :speaking_head: Please join meta.discourse.org, our official community, for documentation and support from other Discourse users.
## :magic_wand: Complete the setup wizard
You've already been through the setup wizard, but if you skipped some steps, you can go back now and update some basic settings at this link: [/wizard](%{base_url}/wizard).
## :handshake: Invite a few people to join you
It's helpful to collaborate with at least one or two other people early that can provide feedback on the decisions you're making about your community.
- **If your community allows people to freely sign up**, send them the link and ask them to join.
- **If your community is invite only**, go to [your invites page](%{base_url}/my/invited) and look for the <kbd>+ Invite</kbd> button to create invite links you can share or directly email everyone you want to have in your community.
2013-12-16 09:46:46 +08:00
> :bulb: Your community starts off in “bootstrap mode”, which gives early members [a higher level of trust ](https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/)than the typical new member so they can help you launch your community. You can adjust how long your community remains in bootstrap mode [here](/admin/site_settings/category/all_results?filter=bootstrap). For more information about bootstrap mode, [see the Discourse Meta documentation](https://meta.discourse.org/t/-/322876).
2013-12-16 09:46:46 +08:00
## :thought_balloon: Discuss ideas with your community
2014-04-19 03:22:49 +08:00
Now that you have a few collaborators, you can start trying things out together and discussing ideas for your community.
To start a new discussion, click the <kbd>+ New Topic</kbd> button on the [latest topics](%{base_url}/latest) page or within any of the following categories.
2014-02-13 03:50:01 +08:00
- [#Site Feedback](%{base_url}/c/-/2) is for discussions about your site, how it works, and how you can improve it. It's designed to be open to participation by everyone who can access your community.
- [#General](%{base_url}/c/-/4) is for topics of general interest to your community. You can create additional categories as you decide how you want to make space for different kinds of topics.
2013-12-16 09:46:46 +08:00
- [#Staff](%{base_url}/c/-/3) is only visible to admins and moderators and can be used for topics you wish to discuss privately with other admins and moderators.
2013-12-16 09:46:46 +08:00
If you'd like to promote any members to become admins or moderators, visit their user page and click on the <kbd>:wrench: Admin</kbd> button, then click <kbd>Grant Admin</kbd> or <kbd>Grant Moderator</kbd>.
2013-12-16 09:46:46 +08:00
> :bulb: You can use [chat](%{base_url}/chat) for faster paced discussions.
2013-12-16 09:46:46 +08:00
## :wave: Update your welcome topic and guidelines
2013-12-16 09:46:46 +08:00
Update the welcome topic in the [#General](%{base_url}/c/-/4) category and the community guidelines on your [FAQ](%{base_url}/faq) page as you see fit. Go through it yourself with your initial members and see if there's anything you want to add or change.
2013-12-16 09:46:46 +08:00
To get you started, think about what you want new members to **know about your community** or **do when they first join**.
2014-04-16 15:13:52 +08:00
## :art: Adjust other customizations
To customize the look and feel of your community beyond what you configured in the [setup wizard](%{base_url}/wizard), you can change the following settings in the [admin section](/admin):
- [Logo images](%{base_url}/admin/site_settings/category/branding)
- [Color schemes](%{base_url}/admin/customize/colors)
- [Font styles](%{base_url}/admin/site_settings/category/all_results?filter=font)
- [Site theme](%{base_url}/admin/customize/themes)
- [Navigation menu](%{base_url}/admin/site_settings/category/navigation)
- [Custom user fields](%{base_url}/admin/customize/user_fields)
- [Terms of service and privacy policies](%{base_url}/admin/site_settings/category/legal)
[details="Advanced options"]
Discourse is very configurable and there is a great deal programmers and web designers can do to customize it, integrate it into other platforms, or address any use case. Users going down this route are highly encouraged to join meta.discourse.org, our support community, to learn from what others have and to give and get advice.
2013-12-16 09:46:46 +08:00
- Add one or more social login options: [Google](https://meta.discourse.org/t/configuring-google-oauth2-login-for-discourse/15858), [Twitter](https://meta.discourse.org/t/configuring-twitter-login-for-discourse/13395), [Facebook](https://meta.discourse.org/t/configuring-facebook-login-for-discourse/13394), [GitHub](https://meta.discourse.org/t/configuring-github-login-for-discourse/13745), [Discord](https://meta.discourse.org/t/configure-discord-login-for-discourse/127129?u=tobiaseigen), [Apple](https://www.discourse.org/plugins/apple-login), [Amazon, LinkedIn, and Microsoft](https://www.discourse.org/plugins/amazon-linkedin-microsoft-login)
- [Embed Discourse in your WordPress website](https://github.com/discourse/wp-discourse), or [on your static HTML site](https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963)
- Set up [single-sign on](https://meta.discourse.org/t/official-single-sign-on-for-discourse/13045) with your main site
- [Build your own login method](https://meta.discourse.org/t/login-to-discourse-with-custom-oauth2-provider/14717)
- [Create your own theme](https://meta.discourse.org/docs?topic=93648)
- [Interact with Discourse from other applications using the API](https://meta.discourse.org/t/create-and-configure-an-api-key/230124?u=tobiaseigen)
[/details]
2013-12-16 09:46:46 +08:00
## :arrows_clockwise: Repeat!
While you're getting started, you may find it helpful to repeat the steps above a few times. Invite a few more people, discuss ideas with them, and make adjustments to your site based on their input and feedback.
After one or two rounds, you should have a good sense of what kind of experience people have as they join your community and be ready to invite a wider audience.
## :rocket: Launch your community
2014-04-16 15:13:52 +08:00
Once you feel like things are in a good place to invite a wider audience, launch your community:
2014-04-16 15:13:52 +08:00
- Publicize your site where you expect to find interested members
- Invite more members
- Help new members find ways to participate
You can continue to improve your community as you receive feedback from you members.
2014-10-09 16:10:27 +08:00
## :books: Learn more
2014-10-09 16:10:27 +08:00
Here are some additional resources from [the Discourse blog](http://blog.discourse.org) and https://meta.discourse.org that you may also want to explore.
- [Building a Discourse Community](http://blog.discourse.org/2014/08/building-a-discourse-community/)
- [Understanding Trust Levels](https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/)
- [What is "Site Feedback"?](https://meta.discourse.org/t/-/5249)
- [How you can use invitations to add users](https://meta.discourse.org/tags/c/documentation/10/invites)
- [Banners and pinned topics](https://meta.discourse.org/t/-/153718)
- [Groups and category permissions](https://meta.discourse.org/t/-/87678)
- [Admin guide to tags](https://meta.discourse.org/t/-/121041)
- [Configuring Discourse Chat](https://meta.discourse.org/t/-/230881)
- [An Overview of Discourse Chat for users](https://meta.discourse.org/t/-/239695)
- [All admin documentation topics](https://meta.discourse.org/c/-/53)
- [All moderator documentation topics](https://meta.discourse.org/c/-/125)
- [All user documentation topics](https://meta.discourse.org/c/-/126)
[details="Additional resources for maintaining your server"]
2013-12-16 09:46:46 +08:00
- One CPU and 1GB of memory, with swap, is the minimum for a basic Discourse community. As your community grows you may need more memory or CPU resources.
- [Our Docker container install](https://github.com/discourse/discourse/blob/main/docs/INSTALL.md) is the only one we officially support. It guarantees easy updates, and all recommended optimizations from the Discourse team.
- You should get an email notification when new versions of Discourse are released. To update your instance via our easy one click process, visit [/admin/update](/admin/update).
2013-12-16 09:46:46 +08:00
### Optional things you might eventually want to set up
- [All sysadmin documentation topics](https://meta.discourse.org/c/-/55)
- [Automatic daily backups](https://meta.discourse.org/t/configure-automatic-backups-for-discourse/14855)
- [HTTPS support](https://meta.discourse.org/t/allowing-ssl-for-your-discourse-docker-setup/13847)
- [Content Delivery Network support](https://meta.discourse.org/t/enable-a-cdn-for-your-discourse/14857)
- [Reply via Email](https://meta.discourse.org/t/set-up-reply-via-email-support/14003)
- [Import and Export your data](https://meta.discourse.org/t/move-your-discourse-instance-to-a-different-server/15721)
- [Change the domain name](https://meta.discourse.org/t/how-do-i-change-the-domain-name/16098)
- [Multiple Discourse instances on the same server](https://meta.discourse.org/t/multisite-configuration-with-docker/14084)
- [Import old content from vBulletin, PHPbb, Vanilla, Drupal, BBPress, etc](https://github.com/discourse/discourse/tree/main/script/import_scripts)
- [Configure a firewall on your server](https://meta.discourse.org/t/configure-a-firewall-for-discourse/20584).
- [A user friendly offline page when rebuilding or upgrading](https://meta.discourse.org/t/adding-an-offline-page-when-rebuilding/45238)
[/details]
----
2013-12-16 09:46:46 +08:00
Have suggestions to improve or update this guide? Submit a [pull request](https://github.com/discourse/discourse/blob/main/docs/ADMIN-QUICK-START-GUIDE.md).