Repository files navigation

A frontend for Octyne.

1. Prerequisites: InstallNode.js andGit. Runcorepack enable in the terminal as admin/sudo to install the Yarn package manager.
2. Download Ecthelion to a folder by runninggit clone https://github.com/retrixe/ecthelion.git in terminal where you wish to place Ecthelion.
3. Select the current version of Ecthelion after downloading it by runninggit checkout <version> in the Ecthelion folder. Alternatively, for the development version, rungit checkout main.
4. Follow the stepshere to configure Ecthelion correctly. After configuration changes, rebuild Ecthelion withyarn && yarn build.
5. Runyarn start to start Ecthelion's built-in web server, you can specify a port by passing-p <port>. Alternatively, you can runyarn export to export Ecthelion to static HTML/CSS/JS files in theout folder you can serve via nginx or Apache, however, supporting dynamic routes will require additional work.
6. To update Ecthelion in the future, rungit pull, then re-run step 3 through 5.

You might want to manage Ecthelion using systemd on Linux systems, which can start and stop Ecthelion, start it on boot, store its logs and restart it on crash.This article should help you out. Alternatively, you can run Ecthelion with Octyne, but if you have issues with Ecthelion, this may be a problem.

Create aconfig.json in the top level of the project and then add the following content:

{"ip":"<absolute URL to Octyne>","nodes": {"<name of node>":"<absolute URL to Octyne node>"  },"basePath":"<pass this if you want ecthelion on a sub-path like e.g. /ecthelion>","enableCookieAuth":false}

⚠️ Important Notes:

• Theip field is required, whilenodes,basePath andenableCookieAuth are optional.
• Absolute URLs to Octyne should be accessible to users (make sure Octyne is port forwarded), and are in the format ofhttp[s]://<ip address or domain name>[:<port>][/<sub-URL if using nginx/apache to reverse proxy>], e.g.http://43.12.45.32:42069 orhttps://console.myserver.com/octyne. The URL should also not end with/!
• Cookie authentication is more secure, but it requires Octyne v1.1+, and Ecthelion + all Octyne nodes must be under 1 domain or IP address! For this, you can use a reverse proxy like nginx or Apache,the Octyne documentation has sample configs for both software to achieve this.