One place for hosting & domains

      Discourse

      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

      How To Install Discourse on Ubuntu 18.04


      An Article from Discourse

      Introduction

      Discourse is an open-source discussion platform. It can be used as a mailing list, a discussion forum, or a long-form chat room. In this tutorial, we’ll install Discourse in an isolated environment using Docker, a containerization application.

      Prerequisites

      Before we get started, there are a few things we need to set up first:

      Note: Discourse requires a swap file if you are using 1 GB of RAM. Although swap is generally recommended for systems utilizing traditional spinning hard drives, using swap with SSDs can cause issues with hardware degradation over time. Due to this consideration, we do not recommend enabling swap on DigitalOcean or any other provider that utilizes SSD storage. Doing so can impact the reliability of the underlying hardware for you and your neighbors. Hence, we recommend a minimum of 2 GB of RAM to run Discourse on a DigitalOcean Droplet. Refer to How To Add Swap Space on Ubuntu 18.04 for details on using swap.

      Step 1 — Downloading Discourse

      With all the prerequisites out of the way, you can go straight to installing Discourse.

      You will need to be root through the rest of the setup and bootstrap process, so first, switch to a root shell.

      Next, create the /var/discourse directory, where all the Discourse-related files will reside.

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

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

      With the files we need in place, we can move on to configuration and bootstrapping.

      Step 2 — Configuring and Bootstrapping Discourse

      Move to the /var/discourse directory, where the Discourse files are.

      From here, you can launch the included setup script.

      You will be asked the following questions:

      • Hostname for your Discourse?

      Enter the hostname you’d like to use for Discourse, e.g. discourse.your_domain.com, replacing your_domain.com with your domain name. You do need to use a domain name because an IP address won’t work when sending email.

      • Email address for admin account?

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

      Note that this email address will be made the Discourse admin by default when the first user registers with that email. You’ll also need this email address later when you set up Discourse from its web 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, the user name and password are SMTP credentials for your domain under domains tab.

      Finally, you will be asked to confirm all the settings you just entered. After you confirm your settings, the script will generate a configuration file called app.yml and then the bootstrap process will start.

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

      Bootstrapping takes between 2-8 minutes, after which your instance will be running! Let’s move on to creating an administrator account.

      Step 3 — Registering an Admin Account

      Visit your Discourse domain in your favorite web browser to view the Discourse web page.

      congratulations

      If you receive a 502 Bad Gateway error, try waiting a minute or two and then refreshing; Discourse may not have finished starting yet.

      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.

      wizard

      After completing or skipping the setup wizard, you’ll see some topics and the Admin Quick Start Guide (labeled READ ME FIRST), which contains tips for further customizing your Discourse installation.

      homepage

      You’re all set! If you need to upgrade Discourse in the future, you can do it from the command line by pulling the latest version of the code from the Git repo and rebuliding the app, like this:

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

      You can also update it in your browser by visiting http://discourse.your_domain.com/admin/upgrade, clicking Upgrade to the Latest Version, and following the instructions.

      upgrade

      Conclusion

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



      Source link