2016-12-28 14:49:51 -08:00
|
|
|
# Misskey
|
|
|
|
[![][travis-badge]][travis-link]
|
2016-12-30 04:38:00 -08:00
|
|
|
[![][appveyor-badge]][appveyor-link]
|
2016-12-28 14:49:51 -08:00
|
|
|
[![][dependencies-badge]][dependencies-link]
|
|
|
|
[![][mit-badge]][mit]
|
|
|
|
|
2016-12-30 20:37:21 -08:00
|
|
|
Welcome!
|
|
|
|
|
2016-12-30 20:48:10 -08:00
|
|
|
Misskey is a completely open source, ultimately sophisticated new type of mini-blog based SNS.
|
2016-12-28 14:49:51 -08:00
|
|
|
|
2016-12-29 03:43:33 -08:00
|
|
|
![ss](./resources/ss.jpg)
|
|
|
|
|
2016-12-30 21:11:31 -08:00
|
|
|
## Feature
|
|
|
|
* Realtime contents
|
|
|
|
* Private chatting (messaging)
|
|
|
|
* Free 1GB storge
|
|
|
|
* Mobile device support (smartphone, tablet, etc)
|
|
|
|
* Thirdparty app support
|
|
|
|
|
|
|
|
and more!
|
|
|
|
|
2016-12-30 21:12:15 -08:00
|
|
|
## Building
|
2016-12-30 14:18:06 -08:00
|
|
|
1. Install *git*, *Node.js* and *npm*
|
2016-12-30 09:44:45 -08:00
|
|
|
2. `git clone git://github.com/syuilo/misskey.git`
|
|
|
|
3. `cd misskey`
|
|
|
|
4. `npm install`
|
|
|
|
5. `npm run config`
|
|
|
|
6. `npm run build`
|
2016-12-28 14:49:51 -08:00
|
|
|
|
2016-12-30 09:44:45 -08:00
|
|
|
## Test
|
|
|
|
`npm test`
|
|
|
|
|
|
|
|
## Setup
|
2016-12-30 14:06:38 -08:00
|
|
|
### Dependencies :package:
|
2016-12-30 09:47:45 -08:00
|
|
|
Please install these softwares.
|
2016-12-30 12:25:26 -08:00
|
|
|
* **[MongoDB](https://www.mongodb.com/)**
|
|
|
|
* **[Redis](https://redis.io/)**
|
|
|
|
* **[GraphicsMagick](http://www.graphicsmagick.org/)**
|
2016-12-30 14:06:38 -08:00
|
|
|
|
|
|
|
#### Optional
|
2016-12-30 20:05:15 -08:00
|
|
|
* [Elasticsearch](https://www.elastic.co/) - used to provide searching feature instead of MongoDB
|
2016-12-28 14:49:51 -08:00
|
|
|
|
2016-12-29 07:23:25 -08:00
|
|
|
### Domains
|
2016-12-28 14:49:51 -08: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.**
|
|
|
|
|
2016-12-29 07:23:25 -08:00
|
|
|
### reCAPTCHA
|
2016-12-30 09:39:46 -08:00
|
|
|
Please visit https://www.google.com/recaptcha/intro/ and generate keys.
|
2016-12-29 07:23:25 -08:00
|
|
|
|
2016-12-30 13:58:52 -08:00
|
|
|
## Setup with Docker :whale:
|
2016-12-30 13:38:14 -08:00
|
|
|
Ensure that the working directory is the repository root directory.
|
|
|
|
|
|
|
|
To create misskey image:
|
2016-12-30 20:00:11 -08:00
|
|
|
`sudo docker build -t misskey ./docker`
|
2016-12-30 13:38:14 -08:00
|
|
|
|
|
|
|
To run misskey:
|
|
|
|
`sudo docker run --rm -i -t -p $PORT:80 -v $(pwd):/root/misskey -v $DBPATH:/data/db misskey`
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
ex: `sudo docker run --rm -i -t -p 80:80 -v $(pwd):/root/misskey -v /data/db:/data/db misskey`
|
|
|
|
|
|
|
|
Note that $(pwd) is the working directory.
|
|
|
|
|
2016-12-28 14:49:51 -08:00
|
|
|
## Launch
|
2016-12-29 07:16:47 -08:00
|
|
|
`sudo npm start`
|
2016-12-28 14:49:51 -08:00
|
|
|
|
2016-12-30 10:50:21 -08:00
|
|
|
## Contribute
|
|
|
|
Do you have feature request or problem with Misskey?
|
|
|
|
Please create issue to report it.
|
|
|
|
|
|
|
|
Currently Misskey is missing documents so writing documents would be appreciated.
|
|
|
|
Pull requests are always welcome.
|
|
|
|
|
2016-12-30 11:02:01 -08:00
|
|
|
We love contributions from anybody.
|
|
|
|
|
2016-12-30 14:09:29 -08:00
|
|
|
[Contribution guide](./CONTRIBUTING.md)
|
|
|
|
|
2016-12-30 12:35:23 -08:00
|
|
|
### TODO
|
2016-12-30 14:15:48 -08:00
|
|
|
* More [tests](./test)!
|
|
|
|
* More [docs](./docs)!
|
2016-12-30 20:53:29 -08:00
|
|
|
* More cleaning up code!
|
2016-12-30 12:35:23 -08:00
|
|
|
|
2016-12-28 14:49:51 -08:00
|
|
|
## License
|
2016-12-30 10:51:12 -08:00
|
|
|
[The MIT License](LICENSE)
|
2016-12-28 14:49:51 -08: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
|
2016-12-30 04:40:19 -08:00
|
|
|
[travis-badge]: http://img.shields.io/travis/syuilo/misskey.svg?style=flat-square&label=Linux
|
2016-12-30 04:38:00 -08:00
|
|
|
[appveyor-link]: https://ci.appveyor.com/project/syuilo/misskey
|
2016-12-30 04:40:19 -08:00
|
|
|
[appveyor-badge]: https://img.shields.io/appveyor/ci/syuilo/misskey/master.svg?style=flat-square&label=Windows
|
2016-12-28 14:49:51 -08:00
|
|
|
[dependencies-link]: https://gemnasium.com/syuilo/misskey
|
|
|
|
[dependencies-badge]: https://img.shields.io/gemnasium/syuilo/misskey.svg?style=flat-square
|