2017-02-22 05:19:34 -06:00
|
|
|
Misskey
|
|
|
|
================================
|
|
|
|
|
2016-12-28 16:49:51 -06:00
|
|
|
[![][travis-badge]][travis-link]
|
|
|
|
[![][dependencies-badge]][dependencies-link]
|
2017-01-24 03:41:07 -06:00
|
|
|
[![][himawari-badge]][himasaku]
|
|
|
|
[![][sakurako-badge]][himasaku]
|
2017-02-26 13:02:24 -06:00
|
|
|
[![][mit-badge]][mit]
|
2017-01-24 03:41:07 -06:00
|
|
|
|
2016-12-30 22:37:21 -06:00
|
|
|
Welcome!
|
|
|
|
|
2017-02-22 05:19:34 -06:00
|
|
|
[Misskey](https://misskey.xyz) is a completely open source,
|
|
|
|
ultimately sophisticated new type of mini-blog based SNS.
|
2016-12-28 16:49:51 -06:00
|
|
|
|
2016-12-29 05:43:33 -06:00
|
|
|
![ss](./resources/ss.jpg)
|
|
|
|
|
2017-02-22 05:19:34 -06:00
|
|
|
Key features
|
|
|
|
--------------------------------
|
2016-12-30 23:15:37 -06:00
|
|
|
* Automatically updated timeline
|
2016-12-30 23:11:31 -06:00
|
|
|
* Private chatting (messaging)
|
2016-12-30 23:15:49 -06:00
|
|
|
* Free 1GB storage
|
2016-12-30 23:11:31 -06:00
|
|
|
* Mobile device support (smartphone, tablet, etc)
|
2016-12-30 23:16:13 -06:00
|
|
|
* Thirdparty application support
|
2017-02-26 23:31:38 -06:00
|
|
|
* Twitter integration
|
2016-12-30 23:11:31 -06:00
|
|
|
|
2017-01-02 14:28:54 -06:00
|
|
|
and more! You can touch with your own eyes at https://misskey.xyz/.
|
2016-12-30 23:11:31 -06:00
|
|
|
|
2017-02-22 05:19:34 -06:00
|
|
|
Setup
|
|
|
|
--------------------------------
|
2016-12-30 16:06:38 -06:00
|
|
|
### Dependencies :package:
|
2016-12-30 11:47:45 -06:00
|
|
|
Please install these softwares.
|
2017-02-22 05:19:34 -06:00
|
|
|
* *Node.js* and *npm*
|
2016-12-30 14:25:26 -06:00
|
|
|
* **[MongoDB](https://www.mongodb.com/)**
|
|
|
|
* **[Redis](https://redis.io/)**
|
|
|
|
* **[GraphicsMagick](http://www.graphicsmagick.org/)**
|
2016-12-30 16:06:38 -06:00
|
|
|
|
|
|
|
#### Optional
|
2016-12-30 22:05:15 -06:00
|
|
|
* [Elasticsearch](https://www.elastic.co/) - used to provide searching feature instead of MongoDB
|
2016-12-28 16:49:51 -06:00
|
|
|
|
2016-12-29 09:23:25 -06:00
|
|
|
### Domains
|
2016-12-28 16:49:51 -06:00
|
|
|
Misskey requires two domains called the primary domain and the secondary domain.
|
|
|
|
|
|
|
|
* The primary domain is used to provide main service of Misskey.
|
|
|
|
* The secondary domain is used to avoid vulnerabilities such as XSS.
|
|
|
|
|
|
|
|
**Ensure that the secondary domain is not a subdomain of the primary domain.**
|
|
|
|
|
2017-02-20 16:34:14 -06:00
|
|
|
#### Subdomains
|
2017-02-22 05:19:34 -06:00
|
|
|
Note that Misskey uses following subdomains:
|
2017-02-20 16:34:14 -06:00
|
|
|
|
|
|
|
* **api**.*{primary domain}*
|
|
|
|
* **auth**.*{primary domain}*
|
|
|
|
* **about**.*{primary domain}*
|
|
|
|
* **dev**.*{primary domain}*
|
|
|
|
* **file**.*{secondary domain}*
|
2017-02-14 09:44:07 -06:00
|
|
|
|
2017-02-22 05:19:34 -06:00
|
|
|
### reCAPTCHA tokens
|
2016-12-30 11:39:46 -06:00
|
|
|
Please visit https://www.google.com/recaptcha/intro/ and generate keys.
|
2016-12-29 09:23:25 -06:00
|
|
|
|
2017-02-22 05:19:34 -06:00
|
|
|
Setup with Docker :whale:
|
|
|
|
--------------------------------
|
2016-12-30 15:38:14 -06:00
|
|
|
Ensure that the working directory is the repository root directory.
|
|
|
|
|
|
|
|
To create misskey image:
|
2016-12-31 02:33:53 -06:00
|
|
|
|
2016-12-30 22:00:11 -06:00
|
|
|
`sudo docker build -t misskey ./docker`
|
2016-12-30 15:38:14 -06:00
|
|
|
|
|
|
|
To run misskey:
|
2016-12-31 02:33:53 -06:00
|
|
|
|
2016-12-30 15:38:14 -06:00
|
|
|
`sudo docker run --rm -i -t -p $PORT:80 -v $(pwd):/root/misskey -v $DBPATH:/data/db misskey`
|
|
|
|
|
2016-12-31 02:36:11 -06:00
|
|
|
where `$PORT` is the port used to access Misskey Web from host browser
|
|
|
|
and `$DBPATH` is the path of MongoDB database on the host for data persistence.
|
2016-12-30 15:38:14 -06:00
|
|
|
|
|
|
|
ex: `sudo docker run --rm -i -t -p 80:80 -v $(pwd):/root/misskey -v /data/db:/data/db misskey`
|
|
|
|
|
2016-12-31 02:33:53 -06:00
|
|
|
If you want to run misskey in production mode, add `--env NODE_ENV=production` like this:
|
|
|
|
|
2016-12-31 02:35:07 -06:00
|
|
|
`sudo docker run --rm -i -t -p 80:80 -v $(pwd):/root/misskey -v /data/db:/data/db --env NODE_ENV=production misskey`
|
2016-12-31 02:33:53 -06:00
|
|
|
|
2016-12-31 02:36:11 -06:00
|
|
|
Note that `$(pwd)` is the working directory.
|
2016-12-30 15:38:14 -06:00
|
|
|
|
2017-02-22 05:19:34 -06:00
|
|
|
Building
|
|
|
|
--------------------------------
|
2017-02-26 13:02:24 -06:00
|
|
|
Run `npm run build` after `npm install`. GLHF!
|
2017-02-22 05:19:34 -06:00
|
|
|
|
|
|
|
Launch
|
|
|
|
--------------------------------
|
2016-12-29 09:16:47 -06:00
|
|
|
`sudo npm start`
|
2016-12-28 16:49:51 -06:00
|
|
|
|
2017-02-22 05:19:34 -06:00
|
|
|
Testing
|
|
|
|
--------------------------------
|
|
|
|
Run `npm test` after building
|
|
|
|
|
|
|
|
Debugging :bug:
|
|
|
|
--------------------------------
|
2017-01-23 06:07:11 -06:00
|
|
|
### Show a debug messages
|
|
|
|
Misskey uses [debug](https://github.com/visionmedia/debug) and namespace is `misskey:*`.
|
2017-01-23 03:25:52 -06:00
|
|
|
|
2017-02-22 05:19:34 -06:00
|
|
|
Contribute
|
|
|
|
--------------------------------
|
2016-12-30 12:50:21 -06:00
|
|
|
Do you have feature request or problem with Misskey?
|
2016-12-31 03:16:27 -06:00
|
|
|
Please create issue to report it if it is about the Misskey implementation itself.
|
2016-12-30 12:50:21 -06:00
|
|
|
|
|
|
|
Currently Misskey is missing documents so writing documents would be appreciated.
|
|
|
|
Pull requests are always welcome.
|
|
|
|
|
2017-01-23 23:52:59 -06:00
|
|
|
*We love contributions from anybody.*
|
2016-12-30 13:02:01 -06:00
|
|
|
|
2016-12-30 16:09:29 -06:00
|
|
|
[Contribution guide](./CONTRIBUTING.md)
|
|
|
|
|
2016-12-30 14:35:23 -06:00
|
|
|
### TODO
|
2016-12-30 16:15:48 -06:00
|
|
|
* More [tests](./test)!
|
|
|
|
* More [docs](./docs)!
|
2016-12-30 22:53:29 -06:00
|
|
|
* More cleaning up code!
|
2016-12-30 14:35:23 -06:00
|
|
|
|
2017-02-22 05:19:34 -06:00
|
|
|
Collaborators
|
|
|
|
------------------------------
|
2017-01-18 04:40:18 -06:00
|
|
|
| ![syuilo](https://avatars2.githubusercontent.com/u/4439005?v=3&s=70) | ![Morisawa Aya](https://avatars0.githubusercontent.com/u/10798641?v=3&s=70)
|
|
|
|
|---|---|
|
|
|
|
| [syuilo](https://syuilo.com) | [Aya Morisawa](https://github.com/ayamorisawa)|
|
|
|
|
|
2017-02-22 05:19:34 -06:00
|
|
|
Copyright
|
|
|
|
------------------------------
|
2017-01-19 05:44:19 -06:00
|
|
|
Misskey is an open-source software licensed under [The MIT License](LICENSE).
|
2016-12-28 16:49:51 -06:00
|
|
|
|
2017-01-23 23:50:31 -06:00
|
|
|
🍮
|
|
|
|
|
2016-12-28 16:49:51 -06:00
|
|
|
[mit]: http://opensource.org/licenses/MIT
|
|
|
|
[mit-badge]: https://img.shields.io/badge/license-MIT-444444.svg?style=flat-square
|
|
|
|
[travis-link]: https://travis-ci.org/syuilo/misskey
|
2017-02-26 10:46:43 -06:00
|
|
|
[travis-badge]: http://img.shields.io/travis/syuilo/misskey/master.svg?style=flat-square
|
2016-12-28 16:49:51 -06:00
|
|
|
[dependencies-link]: https://gemnasium.com/syuilo/misskey
|
|
|
|
[dependencies-badge]: https://img.shields.io/gemnasium/syuilo/misskey.svg?style=flat-square
|
2017-01-24 03:41:07 -06:00
|
|
|
[himasaku]: https://himasaku.net
|
|
|
|
[himawari-badge]: https://img.shields.io/badge/%E5%8F%A4%E8%B0%B7-%E5%90%91%E6%97%A5%E8%91%B5-1684c5.svg?style=flat-square
|
|
|
|
[sakurako-badge]: https://img.shields.io/badge/%E5%A4%A7%E5%AE%A4-%E6%AB%BB%E5%AD%90-efb02a.svg?style=flat-square
|