<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Jenks Guo on Medium]]></title>
        <description><![CDATA[Stories by Jenks Guo on Medium]]></description>
        <link>https://medium.com/@jenksguo?source=rss-1929df74e39d------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*eReOMv1D1v1GRK0x-nXaNA.jpeg</url>
            <title>Stories by Jenks Guo on Medium</title>
            <link>https://medium.com/@jenksguo?source=rss-1929df74e39d------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 02:41:32 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@jenksguo/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Build and Run Filecoin Venus in Testnet]]></title>
            <link>https://jenksguo.medium.com/build-and-run-filecoin-venus-in-testnet-4d8d9b6e2a3e?source=rss-1929df74e39d------2</link>
            <guid isPermaLink="false">https://medium.com/p/4d8d9b6e2a3e</guid>
            <category><![CDATA[testnet]]></category>
            <category><![CDATA[venus-node]]></category>
            <category><![CDATA[filecoin-node]]></category>
            <category><![CDATA[filecoin]]></category>
            <dc:creator><![CDATA[Jenks Guo]]></dc:creator>
            <pubDate>Fri, 02 Aug 2024 07:03:42 GMT</pubDate>
            <atom:updated>2024-08-02T07:03:42.181Z</atom:updated>
            <content:encoded><![CDATA[<p>A step-by-step guide on running Filecoin node implementation Venus on your local machine with multipass.</p><h3>Intro &amp; Overview</h3><p><a href="https://sophon.venus-fil.io/operation/#introducing-venus-products">Venus</a> is an interoperable alternative Filecoin network node implementation, primarily based on Go language. Built by the <a href="https://github.com/ipfs-force-community">IPFS Force team</a>, it works like the the<a href="https://lotus.filecoin.io/"> main implementation Lotus</a> (based on Rust and Go), but with the added benefit of achieving high availability and miner modules designed for larger scale (for example more than 10PiB) operations of Filecoin storage nodes.</p><p>Venus is in a collection of products that is evolving over time, as of June 2024, there are eight modules that one can install for a full implementation that takes care of all life cycles that are needed of a storage provider and storage client.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*6A1vX5rUxdyTW-7M" /></figure><p>Here is a full list:</p><pre>|      Product     |                             Role                            |<br>|:----------------:|:-----------------------------------------------------------:|<br>|       <a href="https://github.com/filecoin-project/venus">Venus</a>      |         Daemon node for Filecoin chain interactions         |<br>|   <a href="https://github.com/ipfs-force-community/sophon-miner">Sophon Miner</a>   |              Proving and winning block rewards              |<br>| <a href="https://github.com/ipfs-force-community/sophon-messager">Sophon Messenger</a> |                   Chain message management                  |<br>|    <a href="https://github.com/ipfs-force-community/sophon-auth">Sophon Auth</a>   |                   Authorization utilities                   |<br>|  <a href="https://github.com/ipfs-force-community/sophon-gateway">Sophon Gateway</a>  | Provides an external interface to control all the services. |<br>|   <a href="https://github.com/filecoin-project/venus-wallet">Venus Wallet</a>   |              Account addresses and wallet keys              |<br>|     <a href="https://damocles.venus-fil.io/">Damocles</a>     |       Task scheduling, sealing, proving &amp; taking deals      |<br>|      <a href="https://droplet.venus-fil.io/">Droplet</a>     |              Data client tool for making deals              |</pre><p>Venus setup is slightly more complicated because it is designed for Filecoin storage providers that run a larger operation to provide enterprise grade services. Learn more about Filecoin storage deals <a href="https://filecoin.io/blog/posts/how-storage-and-retrieval-deals-work-on-filecoin/">here</a> and watch this<a href="https://www.youtube.com/watch?v=Nmw66GZyf48"> detailed video created</a> by Patrick from factor8 on Filecoin storage provision.</p><h3>What this tutorial covers</h3><p>In this tutorial, we will set up a full node service on <a href="https://docs.filecoin.io/basics/what-is-filecoin/networks">Filecoin’s Calibration testnet </a>on Mac to allow querying of the chain information. This only requires the installation of a <a href="https://github.com/ipfs-force-community/sophon-auth">sophon-auth service</a> and the latest stable <a href="https://github.com/ipfs-force-community/sophon-auth">Venus node service</a> This is a fundamental step to deploy a storage node or a client node. For information &amp; assistance on setting up a storage providing node check out <a href="https://venushub.io/incubator/process.html">VenusHub</a> (Venus’ community incubator program).</p><h3>Prerequisites &amp; Prerequisites</h3><h3>Node Versions</h3><p>Network upgrades are an important procedure for the Filecoin nodes to keep up with the latest implementation of <a href="https://github.com/filecoin-project/FIPs">Filecoin Improvement Proposals (FIPs</a>) which might include important protocol updates such as features and economics changes.</p><p>Before starting, check <a href="https://github.com/filecoin-project/venus/discussions">Venus project’s Github discussion</a> where it highlights the latest stable version against Filecoin Network Version (NV). For the duration of this tutorial, NV22 was the latest stable upgrade so <a href="https://github.com/filecoin-project/venus/discussions/6264#discussioncomment-8276619">these versions</a> will be used.</p><p>The current version of this tutorial (June 2024), was written for<a href="https://github.com/filecoin-project/venus/discussions/6264#discussioncomment-8276619"> Network Version 22</a></p><h3>Hardware</h3><p>To run this, a PC or MAC that at least has 8 cores, 12GB of memory and 100GB free storage space on disk is needed. Since we will be spinning up at least two ubuntu with one of them requiring 8 cores, 8GB of memory &amp; 30 GB of disk space.</p><h3>Multipass</h3><p>Because more than one ubuntu machine is needed, a hypervisor is needed to run Virtual Machines (VMs) on a single computer. The choice for this tutorial is <a href="https://multipass.run/install">Multipass</a>, which is a lightweight VM manager developed by <a href="https://canonical.com/">Canonical</a>.</p><p>Follow the guides to install on the machine, then confirm successful installation by opening terminal or cli to check:</p><pre>$ multipass launch - name primary<br>$ Starting primary</pre><p>This might take some time.</p><p>Next use the `list` command to see if VMs are running:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/622/1*EG_4Y9NrBQVHk2gMw1b9mg.png" /></figure><p>The shell can be accessed via `$ multipass shell venus-one` for example.</p><h3>Golang 1.20+</h3><p>Venus requires a Go version later than 1.20. So in each VM install the latest golang by following commands.</p><pre>sudo add-apt-repository ppa:longsleep/golang-backports<br>sudo apt update<br>sudo apt install golang-go</pre><p>Check the golang is installed correctly via `$go version`.</p><pre>$ go version<br>go version go1.22.3 linux/arm64</pre><h3>Step by Step Guide</h3><h3>Node Planning</h3><p>Since Venus is designed for high availability, the sensible installation will involve not just one node. Let’s have a few nodes and assign roles to them as if this is a full setup:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/850/0*UDVkN6sJtEDkdRoA" /></figure><h3>Create Nodes</h3><p>Create the VMs on multipass with the following commands:</p><pre>$ multipass launch lts - name venus-one - memory 2G - disk 10G - cpus 2;<br>$ multipass launch lts - name venus-two - memory 2G - disk 10G - cpus 2;<br>$ multipass launch lts - name venus-three - memory 8G - disk 30G - cpus 8</pre><blockquote>Note: set a higher resource for `venus-three` nodes to allow import of snapshot and hosting of the entire calibration net’s chain information.</blockquote><p>Accidentally created VMs can be deleted here`$ multipass delete xxx` to delete and clear it from the list by using `$ multipass purge`.</p><h3>Download Snapshot</h3><p>Once the machines are all up, access the shell of `venus-three` via `$multipass shell venus-three` and download the calibration net snapshot image from ChainSafe Forest team’s <a href="https://forest.chainsafe.io/#snapshot-service">Snapshot Services</a>. This holds the chain information needed to kick-start Venus node so it does not have to sync from the beginning (2022 November) which will take several months to complete.</p><p>The current snapshot size for calibration net is ~3.5GB which could take some time. You can always find the latest snapshot <a href="https://forest-archive.chainsafe.dev/latest/calibnet/">here</a>. Learn more about the Filecoin blockchain snapshot from<a href="https://www.youtube.com/watch?v=GZ9VhCveRdA"> this video</a> made by the Forest team.</p><p>Notice that the link `<a href="https://forest-archive.chainsafe.dev/latest/calibnet/">https://forest-archive.chainsafe.dev/latest/calibnet/</a>` is a 302 redirect to the latest compressed .car file. Using curly, we can find the actual file address:</p><pre>$ curl -IL https://forest-archive.chainsafe.dev/latest/calibnet/<br>HTTP/2 302<br>date: Wed, 29 May 2024 09:56:04 GMT<br>content-type: text/plain;charset=UTF-8<br>content-length: 6<br>location: /archive/calibnet/latest/forest_snapshot_calibnet_2024–05–29_height_1654931.forest.car.zst<br>report-to: {&quot;endpoints&quot;:[{&quot;url&quot;:&quot;https:\/\/a.nel.cloudflare.com\/report\/v4?s=cIWDl7I2ZFL3KnnXCvhM2wUCpRI60nhI83XTH%2FCze5PdGJL9UFltLEwsB%2FGAU8JztzJwjGyV3vYYlQqffbZVPy7G0kQKWpG9tuZpabEdRoieFvfdy13AJDsRRJN%2BpCUEfdhADxwuoZCJ%2FxWyoixl&quot;}],&quot;group&quot;:&quot;cf-nel&quot;,&quot;max_age&quot;:604800}<br>nel: {&quot;success_fraction&quot;:0,&quot;report_to&quot;:&quot;cf-nel&quot;,&quot;max_age&quot;:604800}<br>server: cloudflare<br>cf-ray: 88b59cc3dfe91f67-MEL<br>alt-svc: h3=&quot;:443&quot;; ma=86400<br>HTTP/2 200<br>date: Wed, 29 May 2024 09:56:05 GMT<br>content-length: 4017798704<br>accept-ranges: bytes<br>content-disposition: attachment; filename*=UTF-8&#39;&#39;forest_snapshot_calibnet_2024–05–29_height_1654931.forest.car.zst; filename=&quot;forest_snapshot_calibnet_2024–05–29_height_1654931.forest.car.zst&quot;<br>etag: &quot;6eeb89e1164dccd7bd6baf6b71971aaf-1&quot;<br>report-to: {&quot;endpoints&quot;:[{&quot;url&quot;:&quot;https:\/\/a.nel.cloudflare.com\/report\/v4?s=PQ4qelxQOU7PILPIyK8N2eTeYfa5vULd23ZJTS%2BKsHONo60j2U%2BJlxVejir0qUTVq6JsMlMMGaFhnLHrRXo3p1GgTsI%2BZW1nDESt2URu85lowlXus3lG0gdw9ZVo7QfnsvaKb8vSqk05xYO%2BrBvh&quot;}],&quot;group&quot;:&quot;cf-nel&quot;,&quot;max_age&quot;:604800}<br>nel: {&quot;success_fraction&quot;:0,&quot;report_to&quot;:&quot;cf-nel&quot;,&quot;max_age&quot;:604800}<br>server: cloudflare<br>cf-ray: 88b59ccadc8c1f67-MEL<br>alt-svc: h3=&quot;:443&quot;; ma=86400</pre><p>On the HTTP 203 response, we can find the redirect address is `/archive/calibnet/latest/forest_snapshot_calibnet_2024–05–29_height_1654931.forest.car.zst`, concatinating it with the domain we get the actual download address `<a href="https://forest-archive.chainsafe.dev/archive/calibnet/latest/forest_snapshot_calibnet_2024-05-29_height_1654931.forest.car.zst">https://forest-archive.chainsafe.dev/archive/calibnet/latest/forest_snapshot_calibnet_2024-05-29_height_1654931.forest.car.zst</a>`.</p><p>To download, in `venus-three` use curl with the new url. The downloaded file should be around 3.9GB large.</p><pre>curl -O https://forest-archive.chainsafe.dev/archive/calibnet/latest/forest_snapshot_calibnet_2024-05-29_height_1654931.forest.car.zst</pre><p>This will take a while depending on your network speed, other setups can continue in the meantime.</p><h3>Install Sophon-auth</h3><p>Access `venus-one` VM and install sophon-auth. This is a module that will allow management of all other services in the venus cluster.</p><p>To install, clone the repo, enter the directory `sophon-auth` use `make` to build sophon-auth from source.</p><pre>$ git clone https://github.com/ipfs-force-community/sophon-auth.git<br>$ cd sophon-auth<br>$ git checkout $ v1.15.0<br>$ make</pre><p>Once successfully installed, you can start the sophon-auth by `nohup ./sophon-auth run &gt; auth.log 2&gt;&amp;1 &amp;`. This starts sophon-auth in the background with logs sent to the auth.log file. To follow the log `tail -f auth.log`.</p><p>By default sophon-auth will not use a database connection and runs on port 8989. But for actual usage, users can change them at `~/.sophon-auth/config.toml`.</p><p>Example:</p><pre>Listen = &quot;127.0.0.1:8989&quot;<br>ReadTimeout = 60000000000<br>WriteTimeout = 60000000000<br>IdleTimeout = 60000000000<br>[Log]<br>LogLevel = &quot;trace&quot;<br>Type = 0<br>HookSwitch = false<br>[DB]<br>Type = &quot;badger&quot;<br>DSN = &quot;&quot;<br>MaxOpenConns = 64<br>MaxIdleConns = 128<br>MaxLifeTime = 120000000000<br>MaxIdleTime = 60000000000<br>Debug = false<br>[Trace]<br>JaegerTracingEnabled = false<br>ProbabilitySampler = 1.0<br>JaegerEndpoint = &quot;localhost:6831&quot;<br>ServerName = &quot;sophon-auth&quot;<br>[Metrics]<br>Enabled = false<br>[Metrics.Exporter]<br>Type = &quot;prometheus&quot;<br>[Metrics.Exporter.Prometheus]<br>RegistryType = &quot;define&quot;<br>Namespace = &quot;sophon_auth&quot;<br>EndPoint = &quot;/ip4/0.0.0.0/tcp/4568&quot;<br>Path = &quot;/debug/metrics&quot;<br>ReportingPeriod = &quot;10s&quot;<br>[Metrics.Exporter.Graphite]<br>Namespace = &quot;sophon_auth&quot;<br>Host = &quot;127.0.0.1&quot;<br>Port = 4568<br>ReportingPeriod = &quot;10s&quot;</pre><h3>Create API Token for Venus</h3><p>In order for Venus to access this service, the `venus-one`’s IP address and an user with API token need to be passed in the venus launch command.</p><p>The IP address can be obtained by `$ multipass info venus-one`, where the IPv4 address in my case `192.168.64.11` needs to be saved for later.</p><pre>Name: venus-one<br>State: Running<br>Snapshots: 0<br>IPv4: 192.168.64.10<br>Release: Ubuntu 24.04 LTS<br>Image hash: 54f6b62cc8d3 (Ubuntu 24.04 LTS)<br>CPU(s): 2<br>Load: 0.13 0.05 0.01<br>Disk usage: 1.5GiB out of 9.6GiB<br>Memory usage: 219.4MiB out of 1.9GiB<br>Mounts: -</pre><p>Create a user with `user add` command name it `venus-user`. Confirm the user is created using `user get` and make the user active:</p><pre>./sophon-auth user add venus-user<br>Add user success: 0a5c6366-f84c-4e1f-81cb-35a53e452b78, next can add miner for this user<br>$ ./sophon-auth user get venus-user<br>name: venus-user<br>state enabled // 2: disable, 1: enable<br>comment:<br>createTime: Fri, 24 May 2024 21:15:28 AEST<br>updateTime: Fri, 24 May 2024 21:15:28 AEST<br>$ ./sophon-auth user active venus-user<br>active user success<br></pre><p>Then generate a token via `token gen`.</p><pre>./sophon-auth token gen — perm admin venus-user<br>generate token success: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoidmVudXMtdXNlciIsInBlcm0iOiJhZG1pbiIsImV4dCI6IiJ9.Xys05DPL499lQSsAdnPhDkPF0uOaWZE6bHDxu7a2T_4</pre><p>Save the user token for later use.</p><h3>Install Venus Daemon</h3><p>Go back to `venus-three` VM’s shell.</p><p>First, install dependencies needed for venus:</p><pre>sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config curl clang build-essential hwloc libhwloc-dev wget -y &amp;&amp; sudo apt upgrade -y</pre><p>Then install venus daemon by cloning github and build it from source just like installing `venus-auth`:</p><p>git clone https://github.com/filecoin-project/venus.git<br>cd venus<br>git checkout v1.15.0<br>make deps<br>make</p><p>To confirm installation, go into the venus directory and check for venus version.</p><pre>$ ./venus version<br>{<br>&quot;Version&quot;: &quot;1.15.0+git.aabda75e&quot;<br>}</pre><h3>Start Venus with Imported Snapshot</h3><p>This step is very important as initially Venus will need to import the snapshot to catch up with the block information, otherwise it will take a long time to sync.</p><p>Things needed to start Venus initially:</p><ul><li>IP address and port of `venus-one` VM’s auth service,</li><li>the `sophon-auth` token for venus-user created earlier</li><li>the path of the earlier snapshot you downloaded on this VM.</li></ul><p>Use the following long command to start Venus daemon with logs sent to `venus.log`.</p><pre>nohup ./venus/venus daemon \<br> - network=calibrationnet \<br> - auth-url=http://192.168.65.4:8989 \<br> - auth-token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoidmVudXMtdXNlciIsInBlcm0iOiJhZG1pbiIsImV4dCI6IiJ9.Xys05DPL499lQSsAdnPhDkPF0uOaWZE6bHDxu7a2T_4 \<br> - import-snapshot /home/ubuntu/snapshots/calibnet/forest_snapshot_calibnet_2024–05–29_height_1654931.forest.car \<br>&gt; venus.log 2&gt;&amp;1 &amp;</pre><p>Following `venus.log` the following should be observed:</p><pre>$ tail -f venus.log<br>2024–05–29T20:40:17.611+1000 INFO badger v2@v2.2007.4/levels.go:183 All 0 tables opened in 0s<br>2024–05–29T20:40:17.623+1000 INFO chain.store chain/store.go:174 check point value: { bafy2bzacecyaggy24wol5ruvs6qm73gjibs2l2iyhcqmvi7r7a4ph7zx3yqd4 }<br>2024–05–29T20:40:17.624+1000 INFO chain.store chain/store.go:592 SetHead { bafy2bzacecyaggy24wol5ruvs6qm73gjibs2l2iyhcqmvi7r7a4ph7zx3yqd4 } 0<br>2024–05–29T20:40:17.725+1000 INFO chain.store chain/store.go:174 check point value: { }<br>176.57 MiB / 5.82 GiB [==&gt; - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ] 2.96% 67.78 MiB/s 01m24s2024–05–29T20:40:20.412+1000 INFO bufbs v2@v2.2007.4/db.go:1027 Storing value log head: {Fid:0 Len:31 Offset:206667252}<br>325.60 MiB / 5.82 GiB [====&gt; - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ] 5.46% 60.07 MiB/s 01m28s2024–05–29T20:40:23.259+1000 INFO bufbs v2@v2.2007.4/db.go:1027 Storing value log head: {Fid:0 Len:31 Offset:382637425}<br>436.64 MiB / 5.82 GiB [======&gt; - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ] 7.33% 54.38 MiB/s 01m38s2024–05–29T20:40:25.835+1000 INFO bufbs v2@v2.2007.4/db.go:1027 Storing value log head: {Fid:1 Len:32 Offset:72795797}<br>903.31 MiB / 5.82 GiB [============&gt; - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ] 15.16% 74.99 MiB/s 01m03s2024–05–29T20:40:29.868+1000 INFO bufbs v2@v2.2007.4/db.go:1027 Storing value log head: {Fid:1 Len:32 Offset:588758025}<br>1.41 GiB / 5.82 GiB [=====================&gt; - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -] 24.19% 84.42 MiB/s 00m52s2024–05–29T20:40:34.902+1000 INFO bufbs v2@v2.2007.4/db.go:1027 Storing value log head: {Fid:2 Len:32 Offset:346973246}<br>1.44 GiB / 5.82 GiB [=====================&gt; - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -] 24.75% 84.39 MiB/s 00m51s2024–05–29T20:40:35.202+1000 INFO bufbs v2@v2.2007.4/levels.go:1000 [Compactor: 0] Running compaction: {level:0 score:1 dropPrefixes:[]} for level: 0</pre><p>After a while, when venus is syncing blocks, check if the blockheight is at the latest using `chain head`. It should be around 16,000+ with no blocks to catch up on:</p><pre>$ ./venus/venus chain head<br>{<br>&quot;Height&quot;: 1655122,<br>&quot;ParentWeight&quot;: &quot;30889013177&quot;,<br>&quot;Cids&quot;: [<br>{<br>&quot;/&quot;: &quot;bafy2bzaceavzeo247nximwihtl7r2vuctkixwg476ey4mem2ws35xsfm2445i&quot;<br>},<br>{<br>&quot;/&quot;: &quot;bafy2bzaceaxbh4tj4jh5xipow6an425q2mntlae6gzt75n6tpruwnhclmbsa4&quot;<br>}<br>],<br>&quot;Timestamp&quot;: &quot;2024–05–29 20:54:00&quot;<br>}</pre><p>Also `sync status` should be `Done!`:</p><pre>sync status<br>{sender:12D3KooWKaD4rUzxNWVty62M7xJFAZqMizbjWBvwr4HZYxj52bJj height=1655121 head={ bafy2bzacedaouyh3uq5ngpudtsqreirz52f4wqtp33ts7kwry6an7cmamkigu bafy2bzaceauo4fbxslg2nts375q6ge5sn6p5afrn7uwhx62rrytai624otjxw bafy2bzaceccqcjx7ya6ycav6gyazjkgdww4plj762plwiyfybcfvrfqgkejic }}<br>Done!</pre><p>If seeing otherwise like the below case, then that means either the snapshot is nor important properly or the process has crashed and you are syncing from block 0.</p><pre>$ ./venus/venus sync status<br>Syncing:<br>SyncTarget: 1<br>Base: 0 { bafy2bzacecyaggy24wol5ruvs6qm73gjibs2l2iyhcqmvi7r7a4ph7zx3yqd4 }<br>Target: 1655049 { bafy2bzaceak7ckzk65eetv7rc2umovpinfejq25znpkkmh663jjbn433vxh3e bafy2bzaceaqsjs2z5mupoih7oejmnjifj2es5q3xpyosjr7vsqctu7h3ohdy2 bafy2bzacecayfsl2le224njbow57wiofnouizohsyuwswd7h7nit543vwouh4 }<br>Current: 0 { bafy2bzacecyaggy24wol5ruvs6qm73gjibs2l2iyhcqmvi7r7a4ph7zx3yqd4 }<br>HeightDiff: 1655049<br>Status: message sync<br>Err: &lt;nil&gt;<br>Waiting:<br>SyncTarget: 2<br>Base: 0 { bafy2bzacecyaggy24wol5ruvs6qm73gjibs2l2iyhcqmvi7r7a4ph7zx3yqd4 }<br>Target: 1655050 { bafy2bzaceayjupb52krrpgxgwob3w2fp7eprulhfh7n5sbf3viuy2vrox6yhk bafy2bzaceafqziy2rs6vvg73yjavtqcrelhsc3r5owgktk3vqtojp57rtb7vs }<br>Current: 0 { bafy2bzacecyaggy24wol5ruvs6qm73gjibs2l2iyhcqmvi7r7a4ph7zx3yqd4 }<br>HeightDiff: 1655050<br>Status: idle<br>Err: &lt;nil&gt;<br>#check sync height<br>$ ./venus/venus chain head<br>{<br>&quot;Height&quot;: 0,<br>&quot;ParentWeight&quot;: &quot;0&quot;,<br>&quot;Cids&quot;: [<br>{<br>&quot;/&quot;: &quot;bafy2bzacecyaggy24wol5ruvs6qm73gjibs2l2iyhcqmvi7r7a4ph7zx3yqd4&quot;<br>}<br>],<br>&quot;Timestamp&quot;: &quot;2022–11–02 05:13:00&quot;<br>}<br>```<br>To start over again, find venus process `ps ef | grep venus` and kills the existing venus process gracefully via `kill -9 &lt;PID&gt;`. Then delete the venus user profile under user directory `rm -F ~/.venus`. Use the long command earlier to retry.<br>Note that if the node has not enough RAM (e.g. less than 8GB) or CPU (e.g. 4 cores) it will likely crash during the import process.<br>Venus APIs ports are specified in the venus config file `$cat ~/.venus/config.toml`. Port 1234 is default so avoid using this for other services.<br>​​[API]<br>ListenAddress = &quot;/ip4/127.0.0.1/tcp/1234/http&quot;<br>…</pre><p>This can be changed via command line without restarting:</p><pre>./venus daemon — api-listen /ip4/0.0.0.0/tcp/3453</pre><p>Venus API is compatible with Lotus so use a combination of `.venus daemon — -help` and <a href="https://lotus.filecoin.io/reference/lotus/chain/">Lotus reference doc</a> to navigate it.</p><h3>Running the node</h3><h3>Automatic Restarts</h3><p>Automatic Start of Venus &amp; Sophon Auth at startup is convenient for cases of unexpected shutdown of the node. One way is to use systemd:</p><p>Create a service file for Venus Daemon in `/etc/systemd/system` named venus.service.</p><pre>sudo nano /etc/systemd/system/venus.service</pre><p>Edit the file with following configurations.</p><pre>[Unit]<br>Description=Venus Daemon<br>After=network.target<br>[Service]<br>User=&lt;username&gt;<br>ExecStart=nohup ~/venus/venus daemon - network=calibrationnet - auth-url=&lt;sophon-auth-ip&gt;:&lt;port&gt; - auth-token=&lt;sophon-auth-api-token&gt; &gt; venus.log 2&gt;&amp;1 &amp;<br>Restart=on-failure<br>Environment=VENUS_PATH=/home/&lt;username&gt;/.venus<br>LimitNOFILE=4096<br>[Install]<br>WantedBy=multi-user.target</pre><p>Replace &lt;username&gt;, &lt;sophon-auth-ip&gt;:&lt;port&gt; &amp; &lt;sophon-auth-api-token&gt; with actual values.</p><p>Reload Systemd and Enable the Service</p><pre>$sudo systemctl daemon-reload<br>$sudo systemctl enable venus<br>$sudo systemctl start venus</pre><p>Check service status by `sudo systemctl status venus`.</p><h3>Static Network Configuration</h3><p>Multipass will assign dynamic IP to nodes under the host, so to ensure sophon-auth’s IP does not change after restart. A bridged network on the host network will need to be created.</p><p>For ubuntu host, follow guide <a href="https://jon.sprig.gs/blog/post/2800">here</a>.</p><p>There is currently a <a href="https://github.com/canonical/multipass/issues/2815">bug</a> on mac, so multipass users cannot create a virtual interface for a bridged network. I am still looking for a solution for this by the time of authoring this tutorial</p><h3>Logging and debugging</h3><p>Most of the logging will be kept in venus.log that were configured earlier. While the process is running, follow logs via `$ tail -f venus.log` to inspect the health of the node.</p><h3>Conclusion</h3><p>This guide provides a way to setup and configure multiple VMs with appropriate roles to run Filecoin Venus node. The important steps such as importing calibrationnet (testnet) snapshot to expedite blockchain synchronization, manage network configuration and automatic start of the service.</p><p>Running a Venus node can help developers explore ways to interact with Filecoin chain information for developments, testing or operations of decentralized storage nodes.</p><p>Here are some useful links::</p><p><a href="https://sophon.venus-fil.io/operation/">Sophon Documentation</a></p><p><a href="https://github.com/filecoin-project/venus">Venus GitHub Repository</a></p><p><a href="https://multipass.run/docs/mac-tutorial">Multipass Documentation</a></p><p><a href="https://filecoin.io/slack">Filecoin Community Slack</a> (#fil-venus &amp; #fil-venus-announcements)</p><p><a href="https://discord.com/invite/yeQ2hcd2TD">Filecoin Discord Channel</a></p><p>Feel free to reach out to the community forums or refer to the official documentation for more detailed information and support.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4d8d9b6e2a3e" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Elevate Your Synology NAS to Interplanetary Heights]]></title>
            <link>https://jenksguo.medium.com/elevate-your-synology-nas-to-interplanetary-heights-3078d49d0eef?source=rss-1929df74e39d------2</link>
            <guid isPermaLink="false">https://medium.com/p/3078d49d0eef</guid>
            <category><![CDATA[ipfs]]></category>
            <category><![CDATA[synology]]></category>
            <dc:creator><![CDATA[Jenks Guo]]></dc:creator>
            <pubDate>Fri, 16 Jun 2023 05:33:47 GMT</pubDate>
            <atom:updated>2023-06-16T05:54:59.296Z</atom:updated>
            <content:encoded><![CDATA[<p>Discover how to install an IPFS node on your Synology NAS and create your personal decentralized storage node.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/918/1*uWz-jbz9VulLaQ2fcBsg7g.png" /></figure><p>Synology NAS home servers remain one of the most cost-effective and efficient solutions for addressing a variety of data storage and file sharing needs in many households. From media streaming and office collaboration to home automation, surveillance, and even remote access, a private cloud storage service can accomplish a great deal.</p><p>While Synology offers its proprietary file system and backup system, the Interplanetary File System (IPFS) presents a resilient, decentralized file storage network designed to withstand challenges at the protocol level. Implementing IPFS on your Synology NAS can provide an excellent solution for storing public or encrypted person1al data. This article will guide you through the process of setting up IPFS on your Synology NAS device using Docker.</p><h3>Pre-requisites</h3><p>To follow this tutorial, you will need</p><ul><li>A Synology NAS server with Disk Station Manager (any capacity)</li><li>A Wi-Fi router (with admin access)</li><li>A devices to access router and Synology admin page (laptop, PC, tablet or phone)</li></ul><p>Here is my setup:</p><ul><li>Synology DS920</li><li>4x Seagate Ironwolf NAS HDD 8TB (RAID5 24TB)</li><li>Netgear Orbi Mesh Wi-Fi Router</li><li>MacBook Pro</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*EooKwlnuHigw08Ck" /></figure><p>My disk RAID configuration is RAID5, which allows one out of the four disks to fail without causing data losses. This configuration reduces my effective storage space to 24TB. Synology’s site offers a handy<a href="https://www.synology.com/en-uk/support/RAID_calculator?hdds=8%20TB%7C8%20TB%7C8%20TB%7C8%20TB"> RAID calculator</a> for reference.</p><h3>Setting up IPFS on Synology NAS</h3><p>The Synology system operates like a mini server, but its system isn’t entirely open. This means you cannot install any open source software you like. However, using DiskStation’s Package Centre to install a docker container to run IPFS. Here’s how:</p><p><strong>Step 1 — Access your Synology DSM</strong></p><p>You should know how to access Synology NAS Synology DiskStation Manager (DSM). If not, follow <a href="https://kb.synology.com/en-au/DSM/tutorial/Quick_Start_External_Access#:~:text=After%20the%20setup%20is%20complete,HTTP%20and%205001%20for%20HTTPS.">this guide</a> to access. I am accessing my DSM using <a href="https://quickconnect.to/">quickconnect.to</a> port forwarding service offered by Synology.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1013/0*d23br-6YF4-uwPiG" /></figure><p>Login page of my Synology DS920 DSM</p><p><strong>Step 2 — Open your Package Center and search for “Docker” and click “Install”.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/792/0*wQUiYyN1jAaoOfcK" /></figure><p><strong>Step 3 — Open Docker app, go to “Registry” and find “ipfs/kubo”, leave the tag as “latest” and click “Select” to install IPFS node software.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*MAmzpjCCSfNKdAUC" /></figure><p><strong>Step 4 — Go to “Image”, you should see “ipfs/kubo:latest” image in the list of images.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*dau3xLvyeX6EWJmP" /></figure><p>In “Network” page, leave network as “bridge”, click on “Next”:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*v-FEJMh8nludHUbF" /></figure><p>You will find more settings on the next page, such as system resources allocation or auto-restart in case of failure. Click on “Next”.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*WCY4c0ESfHvCXnjm" /></figure><p>In the “Port Settings” page, assign memorable ports to allow the webui to work reliably. I simply added 1 to the first two digits of all the container ports numbers as shown in the screenshot below.</p><blockquote>Local Port — Container Port — Type</blockquote><blockquote>5101–4001 — TCP</blockquote><blockquote>5101–4001 — UDP</blockquote><blockquote>6101–5001 — TCP</blockquote><blockquote>9180–8080 — TCP</blockquote><blockquote>9181–8081 — TCP</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*LsnVlnI07PgpF7IR" /></figure><p>I chose not to map any volume to it and left it as default on the next page.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*8-9wBKPGUxSpwhLj" /></figure><p>Now create the container by clicking “Done” on the next page.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*vh-yK9u4tR36GW8-" /></figure><p>Returning to the “Container” section, you should see “ipfs-kubo1” running.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ZRn9MmeR1wHu6yn4" /></figure><p>Congratulations! You now have IPFS running on your Synology home server. Double click on the running container to see the details. You’ll notice port 49159 is assigned to kubo’s webui port 5001.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*QFKCzlDoxoSA69Mo" /></figure><p>In the next step, we’ll figure out how to access the webui so you can upload a file.</p><p><strong>Step 5 — Access IPFS WebUI.</strong></p><p>To access the webui of IPFS, we will need to visit “https://&lt;your-synology-server-subnet-address&gt;:&lt;docker-assigned-port-for-5001&gt;/webui”. So you will need to find out which address in your home router your synology is running on first. Mine is running on “192.168.1.44” so to visit the webui, I will need to visit “<a href="https://192.168.1.44:5001/webui">https://192.168.1.44:6101/webui</a>”.</p><p>Upon loading, you might notice an error. The webui page is experiencing CORS issues when making API calls. We need to configure the IPFS daemon to accept CORS API calls from sources other than localhost or 127.0.0.1.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*6E7wFKHTKV7YVN-S" /></figure><p>Due to Docker’s limitations on Synology DSM, this requires a bit of a workaround. First, copy the first command from step two of the webui home page, starting with ipfs config — json API. HTTPHeaders. Access-Control-Allow-Origin ‘[*http://192.168.1.44:49159&quot;, “http://localhost:3000&quot;, “http://127.0.0.1…. Go to “Terminal” in the ipfs-kubo1 settings page, click on the down arrow and select “Launch with command”.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*bLcc3FJhBPvQ3CEz" /></figure><p>Paste in the command and click “OK” to start the new command line window.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*H3fCZ9zDX8Bbftze" /></figure><p>The main terminal isn’t responsive to our commands due to some issues. However, using this function, we can execute CLI commands one at a time.</p><p>Repeat the same process for the second command ipfs config — json API. HTTPHeaders. Access-Control-Allow-Methods ‘[“PUT”, “POST”]’.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/515/0*YZ0tnMoA4Nrgpu-k" /></figure><p>Now, return to the home page and restart the container.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*K7Bz8iabyiM60-Nl" /></figure><p>If we revisit our Synology URL against the port that the webui is expected to run on, we should be able to use the webui without issues. Go ahead and upload your first file on your private IPFS node!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*pLxRSdLf7GmT1V9a" /></figure><h3>Keep it Secure</h3><p>What we’ve just done is to allow anyone on our router to access our IPFS instance. Without any port forwarding, external users should not be able to access it. However, this is not an ideal approach.</p><p>Unfortunately, Kubo does not come with a token or login system, so it might be better if you implement a login page or key pair for IPFS instance’s access control. A <a href="https://kb.synology.com/en-au/DSM/help/DSM/AdminCenter/file_directory_service_sso?version=7">Synology SSO</a> client might be able to help.</p><p>You should also consider enforcing SSL certificates and firewall rules before exposing your IPFS instance publicly.</p><h3>Benefits of using IPFS on Synology NAS</h3><p><strong>Low resource consumption: </strong>Synology is designed for long-term, efficient operation. Kubo consumes very little system resources.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/497/0*yIx2AxXDcaaDXNfj" /></figure><p><strong>Decentralized and owned by the user: </strong>By running it on your Synology, you contribute to the decentralization of the IPFS network. It’s also beneficial to have your IPFS node up and running all the time to persist your file and help others access the network.</p><p><strong>Scalability and reliability, persists data: </strong>In addition to your PC, laptops, and perhaps Raspberry Pi, Synology provides another place to host your precious data, making it hard to lose.</p><h3>Conclusion</h3><p>Running your private IPFS on Synology home servers using the Docker app provided by its DSM is a fantastic idea. In just a few minutes, you can set it up and get it running. However, securing your instance requires some additional work. Please feel free to reach out to me if you have discovered a good idea on this.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3078d49d0eef" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Build an Interplanetary Photobooth]]></title>
            <link>https://jenksguo.medium.com/build-an-interplanetary-photobooth-64b7ac53d3a9?source=rss-1929df74e39d------2</link>
            <guid isPermaLink="false">https://medium.com/p/64b7ac53d3a9</guid>
            <category><![CDATA[ipfs]]></category>
            <category><![CDATA[photobooth]]></category>
            <dc:creator><![CDATA[Jenks Guo]]></dc:creator>
            <pubDate>Fri, 16 Jun 2023 05:32:21 GMT</pubDate>
            <atom:updated>2023-06-16T05:32:21.544Z</atom:updated>
            <content:encoded><![CDATA[<p>Learn how to integrate a photo booth to IPFS and make your selfie go interplanetary with web3.storage.</p><p>During Web Summit 2022, the <a href="https://filecoin.io/">Filecoin</a> events and creative team set up an amazing exhibition stand at the convention that attracted more than 3500 visitors wanting to learn more about Web3, the InterPlanetary File System (IPFS), and the Filecoin network’s distributed storage solutions.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*e36YbkRwBMRkMA92" /><figcaption>A photo of Filecoin stand at Web Summit 2022, Lisbon, Portugal</figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=64b7ac53d3a9" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[How to Start a Technical Community]]></title>
            <link>https://jenksguo.medium.com/how-to-start-a-technical-community-a75d23acb67c?source=rss-1929df74e39d------2</link>
            <guid isPermaLink="false">https://medium.com/p/a75d23acb67c</guid>
            <category><![CDATA[developer]]></category>
            <category><![CDATA[community-engagement]]></category>
            <category><![CDATA[community-management]]></category>
            <category><![CDATA[developer-relations]]></category>
            <category><![CDATA[community]]></category>
            <dc:creator><![CDATA[Jenks Guo]]></dc:creator>
            <pubDate>Mon, 24 May 2021 00:30:09 GMT</pubDate>
            <atom:updated>2021-06-30T02:26:47.334Z</atom:updated>
            <content:encoded><![CDATA[<p>Technical communities like developer communities differ from normal communities. Here is a few tips on how to get started.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*LklYHqDJaYa2Wvyc" /><figcaption>Photo by John Schnobrich on <a href="https://unsplash.com/photos/2FPjlAyMQTA">unsplash</a></figcaption></figure><p>For many businesses, having a user community is a great way to differentiate from their competitors, add value to products and make users “stick”. They can fuel the gradually flatting signup curve via word of mouth. A community also brings brand loyalty, product evangelism and solidifies growth. As more and more companies are transforming to <a href="https://jenksguo.medium.com/platform-business-do-you-really-get-it-7d4ba920754c">platform businesses</a>, the technical members of a user community really stand out. Technical communities are communities too, but they deserve a different kind of attention.</p><p>This article will discuss how to start a successful and vibrant technical community (or in some contexts a developer community).</p><h3>How does tech community differ?</h3><p>If you think user community members are harsh, tech community members are even harsher. They are short on time, don’t like long engagement. They are anti-marketing and anti-sales, yet they are the ones who might bring you most values to your users. They join your community because usually ran into issues and they need help from others or you directly. They can tell in seconds if a community is legit by how much people are contributing. They likes to attend events to better their skills and become super human, not to buy things.</p><p>Tech community manager you need to:</p><ul><li>be honest</li><li>be clear with your messages</li><li>provide useful information (quick NOs are useful too!)</li><li>be authentic and create a loud voice</li></ul><h3>Don’t create a tech community, find one!</h3><p>If you just got hired as a community manager/developer advocate and your brief was to create a tech community with no money and a very little user base, then you should probably start to look for a new job. Why? Because it is incredibly hard to forge a community without already having one or a huge amount of investment. Even if one manages to build a community from scratch, it is hard to justify the value of it, the return is not going to be enough for the business.</p><blockquote><em>It is not the case of “you build it, they will come:” It needs to evolve from an existing user base.</em></blockquote><p>So do your research first before starting. Observe how users interact with each other currently. Speak to a few hard-core fans of your user base. Find out some insights, such as what programming language they like to use, where they find new technology, product releases and interesting news. What are the common traits of them? Some users might have already started their community without you knowing. Should you start another one or endorse the existing? Then make a decision on investing in the tech community and decide on how to grow it.</p><p>Accounting software giant <a href="https://xero.com/"><strong>Xero</strong></a> has a vibrant grass root community called <a href="https://www.xumagazine.com/">XU Hub</a>, they run user events and publish user magazines. This came from their 2.2 million small and medium businesses users. It is an incredibly powerful community. They have a vibrant developer and app partner community.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*vpZKCtU-hOXhuEOC" /></figure><h3>Start in the right ways</h3><p>No one wants to set the community up for a failure. You probably think you won’t need any guidance and the community can grow organically. But doing the right things early on can really save you time.</p><p><strong>Set a mission &amp; vision of the community</strong></p><p>One of the leadership 101 principles is don’t use a number for a company’s vision or mission. Such as “Reaching X billion users by 2030”, or “We want to produce X million.” Why? Because employees shouldn’t work for a number. They should wake up and work for something beyond numbers. Running a tech community needs to respect this rule too. Community members don’t come to just make your numbers look pretty. They should be there for a good reason. The value proposition needs to be clear.</p><p>So set a mission and vision for your community, make sure everyone who joins understands where you are going with this community and what they are here for.</p><p>A couple of good examples:</p><blockquote><em>“Our mission is to ensure the Internet is a global public resource, open and accessible to all.”</em></blockquote><blockquote><strong><em>— </em></strong><a href="https://www.mozilla.org/en-US/mission/"><strong><em>Firefox developer forum</em></strong></a><strong><em>’s mission</em></strong></blockquote><blockquote><em>“An employee experience platform designed to help people connect, focus, learn, and thrive at work.”</em></blockquote><blockquote><strong><em>— </em></strong><a href="https://techcommunity.microsoft.com/"><strong><em>Microsoft Tech Community</em></strong></a><strong><em> purpose</em></strong></blockquote><p><strong>Get a consistent gathering place &amp; rituals</strong></p><p>Community is a place where your users gather and share ideas. Setting a gathering place is important. But what should it be? And where should it be? Some communities can exist completely online via tools like slack, discord, website forum. In other communities it is important to have an in-person event like meetups, roadshows and sometimes conferences.</p><p>One of the simplest ways of running a community is an regular email newsletter. Setting a good cadence for gathering and some defining rituals brings stability to the community. What could be the defining thing for your community? Is it tips Tuesday, fortnightly catch up or can you ask me anything once a month? Having regular content created like blog, video or webinar published can also achieve the same effects.</p><p>Whatever event you host or content you create, encourage people to share on social, <a href="https://jonahberger.com/how-to-make-your-content-go-viral/">design them to go viral</a>.</p><p><strong>Put in governance &amp; setting expectations right</strong></p><p>Free speech is important, after all community is a place for like minded person to gather. The good behaviors that help the community to grow we need to encourage, but what if someone behaves badly? Do bad actors need to be punished? The answer is yes, governance is important to growing a healthy community.</p><p>Before you make your community public and welcome people with open arms. Make sure you have a set of code of conduct, community guidelines or principles published so you can set the tone and value of the community. For example, diversity and inclusion is an important one to include. Make a list of things that you have zero-tolerance on. Like racism and hate speech. When you face a bad actor, referring the code of conduct, principles &amp; guidelines can be a very powerful</p><blockquote><em>Governance exists because we want the community to be engaging, a place to create good content, and a safe place together.</em></blockquote><p><strong>Recognise the community ambassadors and champions</strong></p><p>There will always, always be a few members of the community who are ultra-active than others. If you spot one or a few, don’t ignore them or treat them as freaks, do the opposite! They are passionate about your community for a good reason, find out why and embrace it.</p><p>I like communities who hold their advocates, ambassadors or champions proud. Have a hall of fame or a list where their names can be found. Give these community leaders some shout outs, kudos from time to time. Sometimes it is useful to have a board or committee for the leaders of the community to really make them heard. Other times, an ambassador program would give the attention and recognition they need. Crediting and recognising the existing members is a good way to give back to the community that created much value for you.</p><p>The successful <a href="https://auth0.com/ambassador-program">Auth0 ambassador program</a> attracted nearly 100 ambassadors in various regions to evangelise their product to developers in their own languages. If they were to run this program it probably would have cost them 10s of millions of dollars already.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*z3geASxPl4W5rqge" /><figcaption>auth0 ambassador program</figcaption></figure><p>Having said the above, some organisations or businesses are not at the scale to be able to support a ambassador program.</p><p><strong>Be prepare to change</strong></p><p>When the community is up and running, people might not use the community for how it was designed. This might drive you crazy, but it is okay. Community members might use them as they see fit. Don’t freak out, as long as the use is within your code and guidelines, allow it, don’t fight them. Listen to the community members and make changes as needed.</p><p>Communities do evolve just like your product should evolve as users shift their behavior.</p><h3>What about an open source communities?</h3><p>There are tech communities, and there are open source tech communities. Open Source communities deserve another level of special care because they are very different.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*KiC4TXp7xYFtH2uU" /></figure><p><strong>Set the ways of working</strong></p><p>Open source community encourages friction-less entry to attract talents. But it doesn’t mean we don’t need to design the communication channels and contribution processes. Explaining the basic things like how users can communicate with the maintainers, how often pull requests are reviewed and whether there are mentors to reach out to when one gets stuck can help to recruit more contributors.</p><p><strong>Decide governance models</strong></p><p>Just making the repository public on GitHub.com is the first step, nothing is going to happen if you don’t decide on how decisions can be made within the community. Do you run a company led, benevolent dictator, or governing board model? Having a governance model can avoid many conflicts and frustration you might cause to the smart minds who are eager to work on the project.</p><blockquote><em>It frustrates developers if they are not clear on how decisions are made and why.</em></blockquote><p><strong>Keep your self out of lawsuits</strong></p><p>Give a license to the project you are working on. Does your project have a permissive one or a restrictive one? Omitting license choices early on will give you a legal hell to deal with down the lane when your project is successful.</p><blockquote><em>Open source development does not attract more legal issues, closed products have just as much.</em></blockquote><p><strong>It is an long term investment</strong></p><p>Open source communities’ return comes slowly, and it will definitely need quite a bit of investment to run. But it is rewarding in the long run. So treat it like a marathon and not a sprint.</p><p>Communities in general are all long term investments. community managers has a tough job of making sure the communities have: good growth, multichannel engagements and activities, good health and sentiments.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*1laYCoeXsaPoaYbD" /><figcaption>Photo by Intricate Explorer on <a href="https://unsplash.com/photos/Ptd-iTdrCJM">unsplash</a></figcaption></figure><p>Open source communities are different because they are for developers who share a common set of values and goals but also build together and collaborate to make free products for everyone. I wrote <a href="https://devblog.xero.com/three-tips-on-running-a-successful-open-source-software-project-ce3028ed0231">another article</a> explains in details how to run a successful open source software project.</p><h3>Summary</h3><p>Tech communities have to emerge from an existing user base, they can’t be created out of thin air. Technical users have different needs and are driven by different things, so they require different kinds of attention. To make it healthy, you will need to start in the right way: set the values right, create rituals, codes and guidelines, embrace the champions and be prepared to go with the flow. If you have an open source community: define ways of working, governance model, license and make it a long term investment. I hope this article can help you start your tech community right from day one.</p><p>Many of my ideas about community building came from the wonderful book called <a href="https://www.apress.com/gp/book/9781484237472"><em>The Business Value of Developer Relations</em></a> by <em>Mary Thengvall</em>. Have a read, there are plenty more gold nuggets in her book.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a75d23acb67c" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Platform Business, Do You Really Get It?]]></title>
            <link>https://jenksguo.medium.com/platform-business-do-you-really-get-it-7d4ba920754c?source=rss-1929df74e39d------2</link>
            <guid isPermaLink="false">https://medium.com/p/7d4ba920754c</guid>
            <category><![CDATA[ecosystem]]></category>
            <category><![CDATA[api]]></category>
            <category><![CDATA[platform]]></category>
            <category><![CDATA[business]]></category>
            <category><![CDATA[business-strategy]]></category>
            <dc:creator><![CDATA[Jenks Guo]]></dc:creator>
            <pubDate>Mon, 17 May 2021 06:39:04 GMT</pubDate>
            <atom:updated>2021-05-17T06:39:04.683Z</atom:updated>
            <content:encoded><![CDATA[<p>Three most important components of a platform business is 1.Focus on transactions 2.Be open 3.Have governance.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*0KlAFaN_nedQt21H" /><figcaption>Photo by Claudio Schwarz on <a href="https://unsplash.com/photos/294j9hG1N3w">unsplash</a></figcaption></figure><p>Back in 2004, if I asked you about <em>GE, Exxon, Shell, Citi &amp; Walmart</em>. Do you know who they are and what they do? What do they have in common? They were once the top public companies by market cap. They are big because they control some of the most vital resources and services we rely on so much, like electricity, oil, gas, finance and retail.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*24Ri5SeNGsKGjC5v" /><figcaption><em>Top companies by market cap in 2004, thanks to Visual Capitalist</em></figcaption></figure><p>Now, fast forward to today, think about a different set of companies: <em>Apple, Alphabet (google), Microsoft, Amazon &amp; Facebook</em>. You know them by heart right? The current biggest ones are not in any of the vital businesses at all, they are platform business. This type of business is able to win the market without making many tangible products or own vital resources. If you think about it, it is actually mind boggling.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/823/0*OvGuc4-S3wRLHum7" /><figcaption><em>Top companies by market cap in 2019, thanks to Visual Capitalist</em></figcaption></figure><blockquote>The rise of the platform businesses era is not coming. It’s here already… and for a few years now.</blockquote><p>In this article I will talk about what it takes to be a platform business, and explain what it really means to be a platform business. So you can set your business strategy or platform strategy up for success.</p><h3>Forget about products, focus on the interactions</h3><p>Traditional businesses focus on selling specific products and services. Then it optimizes the value chain and gains tight control over the value pipeline and process. Think of energy companies like Exxon &amp; BP, they control natural resources: coal, oil and gas. Creating barriers of entry for competitors. They take the leader positions by owning resources or the access to resources. So traditional businesses are running a supply economy at scale.</p><p>Platform businesses differ. They don’t focus on products or services. But they facilitate the exchanges between consumers and producers and encourage interactions to happen on their platform. Instead of blocking participation, they are breaking barriers of entries for participants. Taking <strong><em>AirBnB</em></strong> for example, they don’t own any real estates but they facilitate transactions between renters and landlords. The fees are charged on transactions rather than on something they produced. As a result, they want more people in the ecosystem generating demands for services which in turn attracts more supplies. So platforms are running demand economies at scale.</p><p>The biggest fear for platforms is lack of transactions and participation. Because this is how they fundamentally realize their value.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*GCPstsaXpGwxpxCQ" /><figcaption>Photo by Erick Mclean on <a href="https://unsplash.com/photos/cIOwoljvd_Q">unsplash</a></figcaption></figure><h3>Be open, invite partners to co-create value</h3><p>Platform must have a “default to open” position to encourage participation. The idea is not to do it all and do it yourselves, but to empower third parties to join the business, to build and to innovate together in standardized ways.</p><p>While traditional business tries to shut off competitors and discourage new business to join. The platform businesses welcomes partners with open arms. This is because for a platform business to succeed, they need to achieve critical mass in the economy and network effect. Platform business wants everything to be done within a standard, the one they make. So they are in a “winner takes it all” competing pattern in their region and in their particular space.</p><p>For example, When you download an app, what comes to your mind first? Apple app store or Android play store? They are effectively the standards of software distribution for mobile devices these days. Both Apple iOS and Android have an amazing set of free APIs and SDKs for any company or sole developers to build solutions and sell. So it is incredibly easy for anyone to participate.</p><p>Can you imagine how many people Apple and Google have to hire to produce 5 million apps?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/408/0*TCy2Io7KbY-d8DNs" /><figcaption>How Platform Businesses Differ</figcaption></figure><h3>Govern the participation</h3><p>So it is like a marketplace, you ask? Not quite. Encouraging transactions is what marketplace does, but marketplace compared to platforms has a lack of governance. Most of the actors are allowed to act even if they are a bit naughty. But not in a platform ecosystem.</p><p>A platform must have power to exclude bad actors, steer community behavior and, most importantly, being able to monetize. Rules are essential to encourage healthy interactions and discourage unhealthy interactions. Someone must design these rules and have enough power to enforce them.</p><p>A lot of people believe big platforms must give as much freedom as possible. But as we learn how powerful the platforms are, especially on poorer countries and younger people, we start to realize how important governance is.</p><p>Can you imagine if Facebook and twitter don’t moderate their content? We will have to put up with watching live terrorism day to day.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*DW4Owdu3JKhtamb9" /><figcaption>Photo by Jack Finnigan on <a href="https://unsplash.com/photos/mt3gtjvRp1U">unsplash</a></figcaption></figure><h3>Summary</h3><p>Now the takeaways. Let’s start with the definition:</p><blockquote>“A platform is an open architecture, with rules of governance, designed to facilitate interactions.”</blockquote><p>Focusing on interactions, open architecture and governance, each of the three component is important to the overall concept and cannot be omitted. The undeniable truth is that in the information age, the rules are different than in the industrial age. Platforms are winning over the vital industrial businesses every day. Think about how you can turn your business into a platform business. See how you can empower others to do it! Create value through transactions and interactions rather than doing it yourself.</p><p>I didn’t come up with the above ideas myself, if you want to go deep into the toic, please consider doing <a href="https://www.edx.org/course/platform-strategy-for-business"><strong><em>Platform Strategies for Business</em></strong></a> by Boston University Course via Edx (Kudos to Bryan Williams for getting me on the course). And for the bookworms out there, have a read of this awesome book called <a href="https://www.amazon.com.au/Platform-Revolution-Networked-Transforming-Economy/dp/0393249131"><strong><em>Platform Revolution</em></strong></a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7d4ba920754c" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>