gotosocial/docs/admin/admin_panel.md

# Admin Control Panel

[gotosocial-admin](https://github.com/superseriousbusiness/gotosocial-admin) is a simple webclient that uses the [admin api routes](https://docs.gotosocial.org/en/latest/api/swagger/#operations-tag-admin) to manage your instance. It uses the same OAUTH mechanism as normal clients (with scope: admin), and as such can be hosted anywhere, separately from your instance, or run locally. A public installation is available here: [https://gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin).

## Using the panel
To use the Admin API your account has to be promoted as such:
```
./gotosocial --config-path ./config.yaml admin account promote --username YOUR_USERNAME
```
After this, you can enter your instance domain in the login field (auto-filled if you run GoToSocial on the same domain), and login like you would with
any other client.

<p align="middle">
	<img src="../../assets/admin-panel.png">Screenshot of the GoToSocial admin panel, showing the fields to change an instance's settings</img>
</p>

You can change the instance's settings like the title and descriptions, and add/remove/change domain blocks including a bulk import/export.

## Installing the panel
Build requirements: some version of [Node.js](https://nodejs.org) and yarn.
```
git clone https://github.com/superseriousbusiness/gotosocial-admin.git && cd gotosocial-admin
yarn install
node index.js
```
This will compile a static bundle in `public/`, which can be copied to any webhost, or put into your GoToSocial installation in the `web/admin` directory.
Update docs with better config + installation instructions (#300) * start reworking some documentation * fuller documentation + better docs structure 2021-11-14 15:54:23 +00:00			`# Admin Control Panel`

[documentation] Admin Panel installation + usage (#552) * admin panel documentation * wrap link so it's clickable * format img so it works with mkdocs serve Co-authored-by: tsmethurst <tobi.smethurst@protonmail.com> 2022-05-11 10:25:53 +00:00			[gotosocial-admin](https://github.com/superseriousbusiness/gotosocial-admin) is a simple webclient that uses the [admin api routes](https://docs.gotosocial.org/en/latest/api/swagger/#operations-tag-admin) to manage your instance. It uses the same OAUTH mechanism as normal clients (with scope: admin), and as such can be hosted anywhere, separately from your instance, or run locally. A public installation is available here: [https://gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin).
Update docs with better config + installation instructions (#300) * start reworking some documentation * fuller documentation + better docs structure 2021-11-14 15:54:23 +00:00
[documentation] Admin Panel installation + usage (#552) * admin panel documentation * wrap link so it's clickable * format img so it works with mkdocs serve Co-authored-by: tsmethurst <tobi.smethurst@protonmail.com> 2022-05-11 10:25:53 +00:00			`## Using the panel`
			`To use the Admin API your account has to be promoted as such:`
			```
			`./gotosocial --config-path ./config.yaml admin account promote --username YOUR_USERNAME`
			```
			`After this, you can enter your instance domain in the login field (auto-filled if you run GoToSocial on the same domain), and login like you would with`
			`any other client.`

			`<p align="middle">`
			`<img src="../../assets/admin-panel.png">Screenshot of the GoToSocial admin panel, showing the fields to change an instance's settings</img>`
			`</p>`

			`You can change the instance's settings like the title and descriptions, and add/remove/change domain blocks including a bulk import/export.`

			`## Installing the panel`
			`Build requirements: some version of [Node.js](https://nodejs.org) and yarn.`
			```
			`git clone https://github.com/superseriousbusiness/gotosocial-admin.git && cd gotosocial-admin`
			`yarn install`
			`node index.js`
			```
			This will compile a static bundle in `public/`, which can be copied to any webhost, or put into your GoToSocial installation in the `web/admin` directory.