One place for hosting & domains

      Discourse

      How To Install Discourse on Ubuntu 20.04


      Not using Ubuntu 20.04?


      Choose a different version or distribution.

      The author selected the Free and Open Source Fund to receive a donation as part of the Write for DOnations program.

      Introduction

      Discourse is an open-source discussion platform. You can use Discourse as a mailing list, a discussion forum, or a long-form chat room. In this tutorial, you will install Discourse in an isolated environment using Docker, a containerization application.

      Prerequisites

      Before you get started, there are a few things you will need:

      Step 1 — Downloading Discourse

      Before downloading and installing Discourse, create the /var/discourse directory. This is where all your Discourse-related files will reside:

      sudo mkdir /var/discourse
      

      Finally, clone the official Discourse Docker Image into /var/discourse:

      sudo git clone https://github.com/discourse/discourse_docker.git /var/discourse
      

      With the Discourse Docker image in place, you can now install and configure your platform.

      Step 2 — Installing and Configuring Discourse

      Move to the /var/discourse directory:

      cd /var/discourse
      

      Now launch the included setup script:

      sudo ./discourse-setup
      

      The Discourse installation script will ask the following questions:

      • Hostname for your Discourse?

      Enter discourse.your_domain, or whatever hostname you’ve chosen for your platform.

      • Email address for admin account?

      Choose the email address that you want to use for the Discourse admin account. It can be unrelated to your Discourse domain and can be any email address you find convenient.

      Note that this email address will become the Discourse administrator default. Later, you will need to reuse this email address when you set up Discourse from its control panel.

      • SMTP server address?

      • SMTP user name?

      • SMTP port?

      • SMTP password?

      Enter your SMTP server details for these questions. If you’re using Mailgun, the SMTP server address will be smtp.mailgun.org, and the username and password are the SMTP credentials for your domain under Mailgun’s domains tab.

      Finally, the Discourse installation script will ask you to confirm all these settings. Confirm your settings, and the script will generate a configuration file called app.yml. The installation process will begin automatically.

      Note: If you need to change or fix these settings after installation, edit your /containers/app.yml file and run ./launcher rebuild app. Otherwise, your changes will not take effect.

      The Discourse installation will take approximately 2-8 minutes, after which your instance will be running. Now you can open a web browser and create an administrator account.

      Step 3 — Registering an Administrator Account

      Visit discourse.your_domain in your favorite web browser, and you will see the Discourse ‘Congrats’ splash screen.

      Discourse congratulations screen

      If you receive a 502 Bad Gateway error, try waiting a minute or two and then refreshing your browser; your Discourse installation might not have completed.

      When the page loads, click the blue Register button. You’ll see a form entitled Register Admin Account with the following fields:

      • Email: Choose the email address you provided earlier from the pull-down menu.
      • Username: Choose a username.
      • Password: Choose a strong password.

      Then click the blue Register button on the form to submit it. You’ll see a dialog that says Confirm your Email. Check your inbox for the confirmation email. If you didn’t receive it, try clicking the Resend Activation Email button. If you’re still unable to register a new admin account, please see the Discourse email troubleshooting checklist.

      After registering your admin account, the setup wizard will launch and guide you through Discourse’s basic configuration. You can walk through it now or click Maybe Later to skip.

      Discourse configuration wizard

      After completing or skipping the setup wizard, you’ll see some topics and Discourse’s Admin Quick Start Guide. The quick start guide is labeled READ ME FIRST, and contains tips for further customizing your Discourse installation.

      Discourse homepage and link to Admin Quick Start Guide

      Your Discourse platform is now ready for use. If you need to upgrade Discourse in the future, you can do so from the command line by pulling the latest version of the code from the Git repo and rebuilding the app:

      cd /var/discourse
      sudo git pull
      sudo ./launcher rebuild app
      

      You can also update Discourse in your browser. Visit http://discourse.your_domain/admin/upgrade, click Upgrade to the Latest Version, and following the instructions.

      Discourse upgrade admin upgrade page

      Conclusion

      You can now start managing your Discourse forum and let users sign up. You can learn more about Discourse’s features on the official Discourse About page.



      Source link

      Cómo instalar Discourse en Ubuntu 18.04


      Un artículo de Discourse

      Introducción

      Discourse es una plataforma de debate de código abierto. Puede usarse como una lista de correo, un foro de debate o una sala de chat grande. En este tutorial, instalaremos Discourse en un entorno aislado utilizando Docker, una aplicación de contenedorización.

      Requisitos previos

      Antes de empezar, hay algunas cosas que debemos configurar primero:

      Nota: Discourse necesita un archivo de intercambio si usa 1 GB de RAM. Si bien, en general, el intercambio se recomienda para sistemas que utilizan discos duros giratorios tradicionales, usarlo con SSD puede causar problemas de degradación de hardware con el paso del tiempo. Debido a esta consideración, no recomendamos permitir el intercambio en DigitalOcean o en cualquier otro proveedor que utilice almacenamiento SSD. Hacerlo puede afectar la fiabilidad del hardware subyacente, tanto para usted como para sus vecinos. Por lo tanto, recomendamos un mínimo de 2 GB de RAM para ejecutar Discourse en un Droplet de DigitalOcean. Consulte Cómo agregar espacio de intercambio en Ubuntu 18.04 para obtener información sobre cómo usar el intercambio.

      Paso 1: Descargar Discourse

      Con todos los requisitos previos cumplidos, ahora puede ir directamente a instalar Discourse.

      Deberá ser root durante el resto del proceso de configuración y arranque; por ello, primero realice el cambio a un shell root.

      A continuación, cree el directorio /var/discourse, en el que residirán todos los archivos relacionados con Discourse.

      Por último, clone la imagen Docker oficial de Discourse en /var/discourse.

      • git clone https://github.com/discourse/discourse_docker.git /var/discourse

      Ahora que contamos con los archivos que necesitamos, podemos pasar a la configuración y al arranque.

      Paso 2: Configurar e iniciar Discourse

      Diríjase al directorio /var/discourse, donde se encuentran los archivos de Discourse.

      Desde aquí, puede iniciar la secuencia de comandos de configuración incluida.

      Se le harán las siguientes preguntas:

      • Hostname for your Discourse? (¿nombre de host para su Discourse?)

      Introduzca el nombre de host que desea usar para Discourse, por ejemplo, discourse.your_domain.com, reemplazando your_domain.com con su nombre de dominio. Debe usar un nombre de dominio porque una dirección IP no funciona al enviar correos electrónicos.

      • Email address for admin account? (¿dirección de correo electrónico de la cuenta de administrador?)

      Seleccione la dirección de correo electrónico que desea usar para la cuenta de administrador de Discourse. Puede no estar relacionada con su dominio de Discourse y puede ser cualquier dirección de correo electrónico que considere conveniente.

      Tenga en cuenta que esta dirección de correo electrónico se convertirá en el administrador de Discourse de manera predeterminada cuando se registre el primer usuario con ese correo electrónico. También necesitará esta dirección de correo electrónico más adelante cuando configure Discourse desde el panel de control web.

      • SMTP server address? (¿dirección de servidor SMTP?)

      • SMTP user name? (¿Nombre de usuario SMTP?)

      • SMTP port? (¿Puerto SMTP?)

      • SMTP password? (¿Contraseña SMTP?)

      Introduzca los datos de su servidor SMTP para estas preguntas. Si usa Mailgun, la dirección de servidor SMTP será smtp.mailgun.org, el nombre de usuario y la contraseña son credenciales SMTP para su dominio en la pestaña de dominios.

      Por último, se le solicitará confirmar todas las configuraciones que acaba de introducir. Después de confirmar sus ajustes, la secuencia de comandos generará un archivo de configuración llamado app.yml y, luego, se iniciará el proceso de arranque.

      Nota: Si necesita cambiar o corregir estos ajustes después del arranque, edite el archivo /containers/app.yml y ejecute ./launcher rebuild app para volver a crear la aplicación. De lo contrario, sus cambios no se harán efectivos.

      ¡El arranque tardará entre 2 y 8 minutos y su instancia quedará activa! Ahora crearemos una cuenta de administrador.

      Paso 3: Registrar una cuenta de administrador

      Vaya a su dominio de Discourse en su navegador web favorito para ver la página web de Discourse.

      ¡Felicidades!

      Si recibe un error de puerta de enlace 502, intente esperar un minuto o dos y, luego, actualice la página. Es posible que el arranque de Discourse aún no haya terminado.

      Cuando la página carga, haga clic en el botón azul Register (Registrarse). Verá un formulario titulado Register Admin Account (Registrar cuenta de administrador) con los siguientes campos:

      • Email: Elija la dirección de correo electrónico que suministró anteriormente desde el menú desplegable.
      • Username: Elija un nombre de usuario.
      • Password: Elija una contraseña segura.

      Luego, haga clic en el botón azul Register (Registrarse) en el formulario para enviarlo. Verá un diálogo que indica Confirm your Email (Confirmar su correo electrónico). Busque el correo electrónico de confirmación en su bandeja de entrada. Si no lo recibió, haga clic en el botón Resend Activation Email (reenviar correo electrónico de activación). Si todavía no puede registrar una nueva cuenta de administrador, consulte la lista de comprobación de solución de problemas de correo electrónico de Discourse.

      Después de registrar su cuenta de administrador, se iniciará el asistente de configuración que lo guiará a través de la configuración básica de Discourse. Puede completarlo ahora o hacer clic en Maybe Later (Tal vez más adelante) para omitirlo.

      Asistente

      Después de completar u omitir el asistente de configuración, verá algunos temas y la Guía de inicio rápido del administrador (titulada READ ME FIRST [antes de empezar]), que contiene sugerencias para personalizar la instalación de Discourse.

      Página de inicio

      ¡Ya está listo! Si necesita actualizar Discourse en el futuro, puede hacerlo desde la línea de comandos extrayendo la última versión del código del repositorio de Git y reconstruyendo la aplicación de la siguiente manera:

      • cd /var/discourse
      • git pull
      • ./launcher rebuild app

      También puede actualizarla en su navegador visitando http://discourse.your_domain.com/admin/upgrade, haciendo clic en Upgrade to the Latest Version (Actualizar a la última versión) y siguiendo las instrucciones.

      Actualización

      Conclusión

      Ahora, puede comenzar a administrar su foro de Discourse y permitir que los usuarios se registren. Obtenga más información sobre las funciones de Discourse en la página Discourse About (Acerca de Discourse).



      Source link

      Установка Discourse в Ubuntu 18.04


      Статья из Discourse

      Введение

      Discourse — это платформа для обсуждений с открытым исходным кодом. Ее можно использовать в качестве списка рассылки, форума для обсуждения или тематического чата. В этом обучающем руководстве мы установим Discourse в изолированной среде с помощью Docker, приложения для контейнеризации.

      Предварительные требования

      Прежде чем начать, нам нужно настроить следующее:

      Примечание. Discourse требует наличия файла подкачки при использовании 1 ГБ оперативной памяти. Хотя использование файла подкачки в целом рекомендуется для систем с использованием традиционных жестких дисков, ее использование с SSD-накопителями может со временем вызывать ухудшение работы аппаратного обеспечения. В связи с этим мы не рекомендуем использовать подкачку с DigitalOcean или с любым другим провайдером, использующим SSD-накопители. Использование подкачки может повлиять на надежность соответствующего аппаратного обеспечения у вас и ваших соседей. Поэтому мы рекомендуем использовать не менее 2 ГБ оперативной памяти для запуска Discourse в DigitalOcean Droplet. Дополнительную информацию по использованию подкачки см. в статье Добавление области подкачки в Ubuntu 18.04.

      Шаг 1 — Загрузка Discourse

      Когда все предварительные требования будут выполнены, мы можем перейти к установке Discourse.

      Вам потребуются права root в течение всего процесса настройки и инициализации, поэтому сначала необходимо переключиться на root shell.

      Затем создайте директорию /var/discourse, где будут храниться все связанные с Discourse файлы.

      Затем клонируйте официальный образ Docker Discourse в /var/discourse.

      • git clone https://github.com/discourse/discourse_docker.git /var/discourse

      Когда все необходимые нам файлы будут в наличии, мы сможем перейти к настройке и инициализации.

      Шаг 2 — Настройка и инициализация Discourse

      Перейдите в директорию /var/discourse, где хранятся файлы Discourse.

      Отсюда вы сможете запустить скрипт настройки.

      Вам придется ответить на следующие вопросы:

      • Имя хоста для вашего экземпляра Discourse?

      Введите имя хоста, которое вы хотите использовать для Discourse, например, discourse.your_domain.com, заменив your_domain.com на имя вашего домена. Вам обязательно нужно использовать доменное имя, поскольку IP-адрес не будет работать при отправке электронных писем.

      • Адрес электронной почты учетной записи администратора?

      Выберите адрес электронной почты, который вы хотите использовать для учетной записи администратора Discourse. Он может не иметь никакой связи с вашим доменом Discourse, в качестве адреса может использоваться любой удобный адрес электронной почты.

      Обратите внимание, что этот адрес электронной почты будет использоваться в качестве адреса администратора Discourse по умолчанию, когда первый пользователь зарегистрируется, указав этот адрес электронной почты. Вам потребуется этот адрес электронной почты позже при настройке Discourse из веб-панели управления.

      Введите данные вашего сервера SMTP для этих вопросов. Если вы используете Mailgun, адрес сервера SMTP будет smtp.mailgun.org, а в качестве имени пользователя и пароля необходимо использовать учетные данные SMTP для вашего домена на вкладке доменов.

      После этого вам будет предложено подтвердить все настройки, которые вы только что ввели. После подтверждения ваших настроек скрипт сгенерирует файл конфигурации под названием app.yml, а затем стартует процесс инициализации.

      Примечание. Если вам потребуется изменить или исправить эти настройки после инициализации, внесите изменения в файл /containers/app.yml​​​ и выполните ./launcher rebuild app. В противном случае изменения не вступят в силу.

      Инициализация занимает от 2 до 8 минут, после чего ваш экземпляр будет запущен! Давайте перейдем к созданию учетной записи администратора.

      Шаг 3 — Регистрация учетной записи администратора

      Перейдите на домен Discourse в предпочитаемом вами браузере, чтобы просмотреть веб-страницу Discourse.

      поздравление

      При получении ошибки 502 Bad Gateway, подождите минуту или две, а затем обновите страницу; возможно, Discourse еще не стартовал.

      После загрузки страницы нажмите синюю кнопку Регистрация. Вы увидите форму под названием Регистрация учетной записи администратора со следующими полями:

      • Электронная почта: укажите адрес электронной почты, который вы предоставили ранее, в выпадающем меню.
      • Имя пользователя: укажите имя пользователя.
      • Пароль: укажите надежный пароль.

      Затем нажмите синюю кнопку Регистрация в форме для отправки данных. Вы увидите диалог с надписью Подтвердите ваш адрес электронной почты. Проверьте папку входящих сообщений почты и найдите письмо подтверждения. Если вы не получили письмо, воспользуйтесь кнопкой Отправить письмо активации повторно. Если вам все равно не удалось зарегистрировать новую учетную запись администратора, ознакомьтесь с контрольным списком устранения проблем электронной почты.

      После регистрации учетной записи администратора будет запущен мастер настройки, который поможет выполнить базовую конфигурацию Discourse. Вы можете выполните ее сейчас или нажать Возможно позже, чтобы пропустить.

      мастер

      После использования или пропуска мастера настройки вы увидите ряд тем и краткое руководство по началу работы для администратора (с названием READ ME FIRST), в котором содержатся советы по дальнейшей настройке вашей установки Discourse.

      главная страница

      Настройка выполнена! Если вам потребуется обновить Discourse в будущем, вы можете воспользоваться командной строкой, получив последнюю версию кода из репозитория Git и выполнив пересборку приложения, например, следующим образом:

      • cd /var/discourse
      • git pull
      • ./launcher rebuild app

      Также вы можете выполнить обновление в браузере, указав http://discourse.your_domain.com/admin/upgrade​​ в адресной строке, нажав Обновить до последней версии и следуя инструкциям.

      обновление

      Заключение

      Теперь вы можете осуществлять управление вашим форумом Discourse и разрешить регистрацию пользователей. Дополнительную информацию о возможностях Discourse см. на странице информации о Discourse.



      Source link