@iasenko asked us for a helping hand for all those who would like to install and use Epochtalk
The readme was recently updated and thought useful to also have it here.
https://github.com/epochtalk/epochtalkWill update thread if anything changes
For issues you can drop a question here or open an issue on their
github repo. May look scary to some but not that bad once you get the hang of it.
Edits:
- Updated with latest release
1.12.0
Features - Epochtalk is a single page web application created with
AngularJS - Web/Mobile ready responsive design using
Bourbon - Code is bundled and loaded as needed, for performance, using
Webpack - Designed with performance in mind. Epochtalk's backend utilizes
Postgres as a database.
- Customizable Theming (Branding, coloring, fonts, sizes)
- Fully modular permissions system with roles
System Dependencies (you need to have these installed on the server/VPS)
-
node -
yarn -
Postgres -
Redis -
Nginx
Installation 1. Checkout repository using git:
$ git clone --single-branch --branch v1.12.0 https://github.com/epochtalk/epochtalk.git
2. SSL and Nginx setup:
Install an SSL cert and edit the nginx .conf file (located /etc/nginx/default.conf) with server info and SSL cert info
3. Change directories to /epochtalk and install dependencies using
yarn:
$ cd epochtalk
$ yarn
4. Copy the example.env file
This file specifies the server configurations and is necessary to run the server. You can edit the .env file later to specify the configurations as outlined in the
Configuration section.
$ cd .. # cd back to project root
$ cp example.env .env
You need to rename that file to ".env", so there is no name before the extension
5. Checkout and Run Migrations
Note: If you do not have brew installed, you must manually install
Elixir$ cd .. # (or just change directories outside of the epochtalk directory)
$ brew install elixir # this installs elixir so we can run epoch migrations
$ git clone git@github.com:epochtalk/epoch.git
$ cd epoch
$ mix deps.get # install project deps
$ mix ecto.setup # create and migrate epochtalk database
$ cd ../epochtalk # change directories back to epochtalk root
6. Initialize First User
First ensure that
Postgres is installed and running. Before running Epochtalk for the first time, it is necessary to setup the database and first user account. The CLI tool will create the first board and admin account for the forum. From the root directory of the project run the following command:
$ node cli create-user <username> <email> --password <password> --admin
7. Start the Epochtalk server
Running the "yarn run serve" command will start the Epochtalk webserver and compile all JavaScript and css. Once the server is running, the forum can be viewed at
http://localhost:8080$ yarn run serve
8. Log in and change admin account information
Login to the admin account using the username and password set at step 6. Visit your profile by clicking the link in the top right corner of the page, then change your username and password.
ConfigurationForum configurations can be set either manually or using the admin panel.
- Manual Configuration
The forum server configs can and must be set manually with a .env file in the root directory of the project.
DATABASE_URL="postgres://localhost/epochtalk_dev"
HOST="localhost"
PORT="8080"
PUBLIC_URL="http://localhost:8080"
REDIS_HOST="localhost"
REDIS_PORT="6379"
REDIS_AUTH_PASS=""
- Admin Panel Configuration
Some configurations can also be set using the settings tab in the administration panel.
Congrats, you have a forum !
Show Posts
