Get started with Luminos

It’s dangerous to go alone! Here you have some recommendations that may come in handy after downloading Luminos.

Installing Luminos with Go

Make sure you have a working Go development environment before installing from source.

Use go get to retrieve and install Luminos:

go get menteslibres.net/luminos

Using Luminos with an external web server

If you want to use a web server like Apache or nginx as front, Luminos can be configured to start as a FastCGI server instead of standalone, just edit the settings.yaml file and set server/type to fastcgi:

server:
  type: "fastcgi"
  bind: 127.0.0.1
  port: 9000

Then take a look on how to configure your web server, examples are included on the sidebar menu.

Running Luminos standalone

Luminos can run without an external web server, it has its own standalone server. Just tweak the settings.yaml file and change server/type to standalone and a simple HTTP server will start listening on the configured server and port.

server:
  type: "standalone"
  bind: 127.0.0.1
  port: 9000

Starting the Luminos server

Whether you configure Luminos as a standalone or fastcgi server it can be started just the same.

Here’s an example on how you can serve a copy of this site in your own OSX, FreeBSD or Linux box.

First, make sure Luminos is in standalone mode and then use the luminos run command:

mkdir -p ~/projects
cd ~/projects
git clone https://github.com/xiam/luminos.menteslibres.org.git
cd luminos.menteslibres.org
luminos run

Now try to open the address http://127.0.0.1:9000 with a browser.

You can also start with a smaller example project using the luminos init command:

mkdir -p ~/projects
cd ~/projects
luminos init luminos-example-project
cd luminos-example-project
luminos run

You may use any of the examples above as a starting point for your own site.

Note: Make sure the $GOPATH/bin directory is in your $PATH, otherwise the luminos binary would not be found.

Site examples

If you would like to see full site examples you can browse the source code of this site at the github project page.

The gosexy.org site uses Luminos too and the source code is freely available in github.

Markdown editors