Skip to content
This repository was archived by the owner on Apr 16, 2020. It is now read-only.

Commit a7b187f

Browse files
committed
Standardized README and added LICENSE
See ipfs/community#124
1 parent 885cc3c commit a7b187f

File tree

2 files changed

+64
-29
lines changed

2 files changed

+64
-29
lines changed

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
The MIT License (MIT)
2+
3+
Copyright (c) 2016 IPFS Community
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in
13+
all copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21+
THE SOFTWARE.

README.md

Lines changed: 43 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,11 @@
1-
#Astral Boot
1+
# astralboot
22

3-
Simon Kirkby
4-
5-
20150304
3+
[![](https://img.shields.io/badge/made%20by-Protocol%20Labs-blue.svg?style=flat-square)](http://ipn.io)
4+
[![](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](http://ipfs.io/)
5+
[![](https://img.shields.io/badge/freenode-%23ipfs-blue.svg?style=flat-square)](http://webchat.freenode.net/?channels=%23ipfs)
6+
[![standard-readme compliant](https://img.shields.io/badge/standard--readme-OK-green.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
67

7-
This repository has been moved to gb format https://getgb.io/ , it’s cool.
8-
9-
## Description
8+
> a low level boot server that deploys directly out of ipfs
109
1110
Astralboot is a golang server that provides network services to boot virtual and metal machines from pxe boot.
1211
The following services are provided
@@ -19,35 +18,46 @@ It can pull its data files out of [ipfs](http://ipfs.io/), which means that they
1918

2019
Local file serving also works with local file system folders ( see INSTRUCTIONS for details )
2120

22-
## Required for development
21+
## Table of Contents
2322

24-
1. golang dev environment
25-
2. running ipfs node
26-
3. a network under your control.
27-
28-
## Warning
23+
- [Install](#install)
24+
- [Usage](#usage)
25+
- [Required for development](#required-for-development)
26+
- [Warning](#warning)
27+
- [Setup](#setup)
28+
- [Running the server](#running-the-server)
29+
- [Changing the services](#changing-the-services)
30+
- [TODO](#todo)
31+
- [Contribute](#contribute)
32+
- [License](#license)
2933

30-
As this server has a naive dhcp server it can be dangerous to run in an office environment. Running this server can interfere with normal network services.
34+
# Install
3135

32-
## Installation
33-
34-
assumes a working golang environment.
36+
Assumes a working golang environment.
3537

3638
```sh
37-
3839
git clone github.com/zignig/astralboot
3940

4041
cd astralboot
4142

4243
gb build
43-
4444
```
4545

46-
also the ipfs service, which is currently in alpha , is available from http://github.com/ipfs/go-ipfs
46+
You will also need to have the [go-ipfs implemenation](http://github.com/ipfs/go-ipfs) installed, and a daemon running.
4747

48-
will need to be installed and running
48+
# Usage
4949

50-
## Setup
50+
## Required for development
51+
52+
1. golang dev environment
53+
2. running ipfs node
54+
3. a network under your control.
55+
56+
## Warning
57+
58+
As this server has a naive dhcp server it can be dangerous to run in an office environment. Running this server can interfere with normal network services.
59+
60+
## Setup
5161

5262
Testing so far has been done on a virtual machine with two network interfaces, one on a home network and the other an isolated VM network.
5363

@@ -103,7 +113,7 @@ Debian will be fairly quick , coreos will take some time as the .gz file is 165
103113

104114
To precache the files into ipfs, run ipfs refs -r HashFromConfigFile and it will download everything
105115

106-
# Changing the Services
116+
# Changing the services
107117

108118
As the server boots it will show an implied config , this shows possible entries to the config file to change.
109119

@@ -116,12 +126,16 @@ ipfs get -o=data “hash from the refs.toml file”
116126
```
117127
If the config has IPFS = false the local file system will be used.
118128

119-
# Development
129+
# TODO
120130

121-
all comments, patches and pull requests welcome
122-
123-
# TODO
124-
125-
1. Better templating of preseed
131+
1. Better templating of preseed
126132
2. Add more operating systems
127133
4. More stuff
134+
135+
# Contribute
136+
137+
All comments, patches and pull requests welcome.
138+
139+
# License
140+
141+
MIT

0 commit comments

Comments
 (0)