1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/timemachine_ynh.git synced 2024-09-03 20:26:33 +02:00
timemachine_ynh/README.md
2023-12-19 04:06:39 +00:00

65 lines
2.9 KiB
Markdown

<!--
N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/README-generator
It shall NOT be edited by hand.
-->
# Time Machine for YunoHost
[![Integration level](https://dash.yunohost.org/integration/timemachine.svg)](https://dash.yunohost.org/appci/app/timemachine) ![Working status](https://ci-apps.yunohost.org/ci/badges/timemachine.status.svg) ![Maintenance status](https://ci-apps.yunohost.org/ci/badges/timemachine.maintain.svg)
[![Install Time Machine with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=timemachine)
*[Lire ce readme en français.](./README_fr.md)*
> *This package allows you to install Time Machine quickly and simply on a YunoHost server.
If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/install) to learn how to install it.*
## Overview
Package to create a Time Machine Backup Source
### Features
- Automatically detected by Time Machine
- Integrated with YunoHost's Backups
- Supports multiple installs
**Shipped version:** 1.0~ynh5
## Screenshots
![Screenshot of Time Machine](./doc/screenshots/example.jpg)
## Disclaimers / important information
* Known limitations
* Only the *.local location is detected automatically. To use the domain, you need to first manually connect to the server using the command `open THE_CONNECTION_STRING` on your Mac
* There is currently no granular control for disallowing connections from hosts (i.e anyone with the username, password and domain can connect to the Time Machine Volume)
* Connecting manually:
* The connection string format is also sent via e-mail `smb://timemachine:password@IP_OR_DOMAIN/timemachine`
* In Finder, use `Command+K` and enter the connection string. If `timemachine` is greyed out, you might need to unmount the volume using the command `sudo umount /Volumes/timemachine` first
* Disallowing connections from outside network:
* Edit either `/etc/samba/smb.conf` or `/etc/smb/smb.d/timemachine.conf` (An option might be added in the future)
## Documentation and resources
* Official app website: <https://support.apple.com/en-us/HT201250>
* Upstream app code repository: <https://github.com/YunoHost-Apps/timemachine_ynh>
* YunoHost Store: <https://apps.yunohost.org/app/timemachine>
* Report a bug: <https://github.com/YunoHost-Apps/timemachine_ynh/issues>
## Developer info
Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/timemachine_ynh/tree/testing).
To try the testing branch, please proceed like that.
``` bash
sudo yunohost app install https://github.com/YunoHost-Apps/timemachine_ynh/tree/testing --debug
or
sudo yunohost app upgrade timemachine -u https://github.com/YunoHost-Apps/timemachine_ynh/tree/testing --debug
```
**More info regarding app packaging:** <https://yunohost.org/packaging_apps>