Skip to content

Commit

Permalink
Update readme.md
Browse files Browse the repository at this point in the history
  • Loading branch information
kroese authored Nov 10, 2024
1 parent 4cf8f87 commit d7da6af
Showing 1 changed file with 70 additions and 1 deletion.
71 changes: 70 additions & 1 deletion .github/readme.md
Original file line number Diff line number Diff line change
@@ -1 +1,70 @@
xxx
<h1 align="center">CasaOS<br />
<div align="center">
<a href="https://github.com/dockur/casaos"><img src="https://raw.githubusercontent.com/dockur/casaos/master/.github/logo.png" title="Logo" style="max-width:100%;" width="128" /></a>
</div>
<div align="center">

[![Build]][build_url]
[![Version]][tag_url]
[![Size]][tag_url]
[![Package]][pkg_url]
[![Pulls]][hub_url]

</div></h1>

Docker container of [CasaOS](https://casaos.zimaspace.com/) (an OS for self-hosting).

## Features ✨

* Does not need dedicated hardware or a virtual machine!

## Usage 🐳

Via Docker Compose:

```yaml
services:
casaos:
image: dockurr/casaos
container_name: casaos
ports:
- 80:80
volumes:
- "/home/example:/DATA"
- "/var/run/docker.sock:/var/run/docker.sock"
stop_grace_period: 1m
```
Via Docker CLI:
```bash
docker run -it --rm -p 80:80 -v /home/example:/DATA -v /var/run/docker.sock:/var/run/docker.sock --stop-timeout 60 dockurr/casaos
```

## FAQ 💬

### How do I change the storage location?

To change the storage location, include the following bind mount in your compose file:

```yaml
volumes:
- /home/example:/DATA
```
Replace the example path `/home/example` with the desired storage folder.

## Stars 🌟
[![Stars](https://starchart.cc/dockur/casaos.svg?variant=adaptive)](https://starchart.cc/dockur/casaos)

[build_url]: https://github.com/dockur/casaos/
[hub_url]: https://hub.docker.com/r/dockurr/casaos
[tag_url]: https://hub.docker.com/r/dockurr/casaos/tags
[pkg_url]: https://github.com/dockur/casaos/pkgs/container/casaos

[Build]: https://github.com/dockur/casaos/actions/workflows/build.yml/badge.svg
[Size]: https://img.shields.io/docker/image-size/dockurr/casaos/latest?color=066da5&label=size
[Pulls]: https://img.shields.io/docker/pulls/dockurr/casaos.svg?style=flat&label=pulls&logo=docker
[Version]: https://img.shields.io/docker/v/dockurr/casaos/latest?arch=amd64&sort=semver&color=066da5
[Package]:https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fipitio.github.io%2Fbackage%2Fdockur%2Fcasaos%2Fcasaos.json&query=%24.downloads&logo=github&style=flat&color=066da5&label=pulls

0 comments on commit d7da6af

Please sign in to comment.