Skip to content

Commit 20384ef

Browse files
committed
Updated readme
1 parent ded8e3e commit 20384ef

9 files changed

+25
-43
lines changed

README.md

+25-43
Original file line numberDiff line numberDiff line change
@@ -1,69 +1,51 @@
11
# gitea-spk
22

3-
Fork from gogs-spk to create a SPK package for [Gitea](https://github.com/go-gitea/gitea), a Gogs fork.
3+
Fork from [gogs-spk](https://github.com/alexandregz/gogs-spk) to create a SPK package for [Gitea](https://github.com/go-gitea/gitea), a [Gogs](https://gogs.io/) fork.
44

5-
Gitea has pre-compiled binaries for ARM available on their repo https://github.com/go-gitea/gitea/releases
5+
### Dependencies
66

7-
Remember to rename the binary to just "gitea" when putting it into the 1_create_package/gitea/ folder.
7+
The Gitea package requires the **[Git Server](https://www.synology.com/en-global/dsm/packages/Git)** package.
88

9-
Tested to work on DS116 with Gitea 1.0.1
9+
### Package creation
1010

11-
## Original:
11+
To create the package, clone the repository:
1212

13-
# gogs-spk
13+
`$ git clone https://github.com/flipswitchingmonkey/gitea-spk.git`
1414

15-
[Gogs](https://gogs.io) (Go Git Service) SPK package ([Synology PacKages](https://www.synology.com/en-us/dsm/app_packages))
15+
Change into the newly created directory - the root directory:
1616

17-
Install Gogs into a Synology NAS.
17+
`$ cd gitea-spk`
1818

19-
## Requirements
19+
Download the Gitea binary matching your architecture from https://github.com/go-gitea/gitea/releases into the root directory. For example, a DiskStation with an ARMv7 CPU would require:
2020

21-
<sub>this package, to see Gogs requirements check https://gogs.io</sub>
21+
`$ wget https://github.com/go-gitea/gitea/releases/download/v1.1.4/gitea-1.1.4-linux-arm-7`
2222

23-
* armv7 (Tested only with DS213j, Marvell Armada 370)
24-
* MariaDB
25-
* Git Server
23+
Invoke the build script to have the package created:
2624

27-
## Usage
25+
`$ ./create_spk.sh`
2826

29-
Change **Package Center -> Trust Level** to **Any Publisher** and import manually the package from **Manual install**.
30-
Finally, install with Gogs web installation.
27+
The install package matching your binary (here `gitea-1.1.4-linux-arm-7.spk`) will be created in the root directory.
3128

32-
## To use with another arch
29+
If you have several binaries downloaded, you can specify the binary for which the package should be created:
3330

34-
Download the binary from https://gogs.io/docs/installation/install_from_binary, replace the content from **1_create_package/gogs** directory and exec create_spk.sh:
31+
`$ ./create_spk.sh gitea-1.1.3-linux-arm-7`
3532

36-
```alex@vostok:/Volumes/HD/Development/synology/gogs-spk(master)$ rm -rf 1_create_package/gogs/ && tar zxvf gogs_v0.9.13_linux_386.tar.gz -C 1_create_package/```
33+
### Installation
3734

38-
```$ sh create_spk.sh```
35+
Make sure **Package Center > Settings > General > Trust Level** is set to **Any Publisher** and perform installation via **Package Center > Manual Install**.
3936

37+
![Select Package](screenshots/install_select_package.png)
4038

41-
## Compiled from source
39+
The installer will create the (internal) user/group gitea:gitea when not found and the executable is run with this user.
4240

43-
Suggested by [hirakujira](https://github.com/hirakujira)
41+
![Select Package](screenshots/install_running.png)
4442

45-
```
46-
GOOS=linux GOARCH=arm GOARM=7 go get -u github.com/gogits/gogs
47-
```
43+
When installation has finished, the package center shows url and status of your Gitea server.
4844

45+
When accessed for the first time, Gitea will greet you with the installation settings. You should set your **Repository Root Path** to a shared folder. You can configure permissions for shared folders in the control panel via **Edit > Permissions > System internal user** to grant the Gitea user permission.
4946

50-
## Screenshots
47+
Tested to work on DS116 with Gitea 1.0.1.
5148

52-
![Install](screenshots/install2.png)
49+
### Acknowledgements
5350

54-
![Install](screenshots/install.png)
55-
56-
![Stopping](screenshots/stopping.png)
57-
58-
![Desktop icon](screenshots/icon.png)
59-
60-
61-
Gogs screenshots
62-
https://github.com/gogits/gogs
63-
64-
65-
## ToDo
66-
67-
- Don't force to use Git Server and MariaDB (PostgreSQL? Gogs ARM version haven't Sqlite/TiDB)
68-
- Support to archs (and DBs)
69-
- Don't use **root** user and create and use **gogs** user, if possible
51+
Original code copyright (c) 2016 Alexandre Espinosa Menor

screenshots/dashboard.png

-54 KB
Binary file not shown.

screenshots/icon.png

-265 KB
Binary file not shown.

screenshots/install.png

-199 KB
Binary file not shown.

screenshots/install2.png

-199 KB
Binary file not shown.

screenshots/install_running.png

177 KB
Loading
106 KB
Loading

screenshots/started.png

-99.5 KB
Binary file not shown.

screenshots/stopping.png

-96 KB
Binary file not shown.

0 commit comments

Comments
 (0)