https://github.com/piku/piku-bootstrap

Bootstrap Piku onto a server
https://github.com/piku/piku-bootstrap

Last synced: about 2 months ago
JSON representation

Bootstrap Piku onto a server

• Host: GitHub
• URL: https://github.com/piku/piku-bootstrap
• Owner: piku
• Created: 2021-04-25T13:35:48.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2023-09-23T07:29:50.000Z (about 1 year ago)
• Last Synced: 2024-05-01T20:07:45.620Z (5 months ago)
• Language: Shell
• Size: 27.3 KB
• Stars: 14
• Watchers: 5
• Forks: 11
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Bootstrap [Piku](https://github.com/piku/piku) onto a fresh Ubuntu server. Piku lets you do `git push` deploys to your own server.

The easiest way to get started is using the get script:

```

ssh root@YOUR-FRESH-UBUNTU-SERVER

curl https://piku.github.io/get | sh

```

Or you can do the steps manually yourself:

```

ssh root@YOUR-FRESH-UBUNTU-SERVER

curl -s https://raw.githubusercontent.com/piku/piku-bootstrap/master/piku-bootstrap > piku-bootstrap

chmod 755 piku-bootstrap

./piku-bootstrap first-run

```

Use `./piku-bootstrap first-run --no-interactive` to suppress the first-run prompt, for example if you are running this in a provisioning script.

**Warning**: Please use a fresh Ubuntu server as this script will modify system level settings.

See [piku.yml](./playbooks/piku.yml) to see what will be changed.

The first time it is run `piku-bootstrap` will install itself into `/root/.piku-bootstrap` on the server and set up a virtualenv there with the dependencies it requires. It will only need to do this once.

The script will display a usage message and you can then bootstrap your server:

```shell

./piku-bootstrap install

```

Once you're done head over to the [Piku documentation](https://github.com/piku/piku/#using-piku) to see how to deploy your first app.

### Installing other dependencies

`piku-bootstrap` uses Ansible internally and it comes with some extra built-in playbooks which you can use to bootstrap common components onto your `piku` server.

Use `piku-bootstrap list-playbooks` to show a list of built-in playbooks, and then to install one add it as an argument to the bootstrap command.

For example, to deploy `postgres` onto your server:

```shell

piku-bootstrap install postgres.yml

```

You can also use `piku-bootstrap` to run your own Ansible playbooks like this:

```shell

piku-bootstrap install ./myplaybook.yml

```