README
¶
0-OS 
0-OS is an autonomous operating system design to expose raw compute, storage and network capacity.
This repository host the V2 of 0-OS which is a complete rewrite from scratch. If you want to know about the history and decision that motivated the creation of the V2, you can read this article
0-OS is mainly used to run node on the Threefold Grid. Head to https://threefold.io to learn more about Threefold and the grid.
Documentation
Start exploring the code base by first checking the documentation and specification documents
Setting up your development environment
If you want to contribute read the contribution guideline and the documentation to setup your development environment
Grid Networks
0-OS is deployed on 3 different "flavor" of network:
- production network: Released of stable version. Used to run the real grid with real money. Cannot be reset ever. Only stable and battle tested feature reach this level. (At the time of writhing this network is not live yet)
- test network: Mostly stable features that need to be tested at scale, allow preview and test of new features. Always the latest and greatest. This network can be reset sometimes, but should be relatively stable. Uses BCDB hosted at
explorer.testnet.grid.tf:8901 - dev network: ephemeral network only setup to develop and test new features. Can be created and reset at anytime. Uses a mock of BCDB hosted at
https://explorer.devnet.grid.tf. This mock is also meant for developer to run locally in their development environment.
Learn more about the different network by reading the upgrade documentation
Provisioning of workloads
ZOS does not expose an interface, instead of wait for reservation to happen on a trusted source, and once this reservation is available, the node will actually apply it to reality. You can start reading about provisioning in this document.
Currently zos supports two different source:
- BCDB
- BCDB mock
Owners
@zaibon @maxux @muhamadazmy @delandtj @leesmet
Meetings
The team holds a update meeting twice a week, on monday and thursday at 10AM.
Zoom URL: https://tinyurl.com/zosupdate
Directories
¶
| Path | Synopsis |
|---|---|
|
cmds
|
|
|
capacityd
command
|
|
|
contd
command
|
|
|
flistd
command
|
|
|
identityd
command
|
|
|
internet
command
|
|
|
networkd
command
|
|
|
provisiond
command
|
|
|
storaged
command
|
|
|
vmd
command
|
|
|
zlf
command
|
|
|
zui
command
|
|
|
gedis
Package gedis implements a client for Gedis (https://github.com/threefoldtech/digitalmeX/tree/master/docs/Gedis)
|
Package gedis implements a client for Gedis (https://github.com/threefoldtech/digitalmeX/tree/master/docs/Gedis) |
|
network/tnodb
Package tnodb expose the interface required to talk to a Tenant network object database (TNODB)
|
Package tnodb expose the interface required to talk to a Tenant network object database (TNODB) |
|
provision
Package provision is a daemon that pulls on reservation source, and then tries to apply these reservations locally.
|
Package provision is a daemon that pulls on reservation source, and then tries to apply these reservations locally. |
|
zdb
Package zdb implements a client to 0-db: https://github.com/threefoldtech/0-DB
|
Package zdb implements a client to 0-db: https://github.com/threefoldtech/0-DB |
|
zinit
Package zinit exposes function to interat with zinit service life cyle management
|
Package zinit exposes function to interat with zinit service life cyle management |
|
tools
|
|
|
bcdb_mock
command
|
|
|
schemac
command
|
|
|
storagesize
command
|
|
|
tffarmer
command
|
|
|
tfuser
command
|
|
|
updatectl
command
|